@gntik-ai/blocks 0.11.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 (182) hide show
  1. package/dist/index.d.ts +1501 -1232
  2. package/dist/index.js +1884 -836
  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.test.tsx +6 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +4 -1
  10. package/src/auth/ForgotPasswordForm/block.meta.ts +1 -1
  11. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  12. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  13. package/src/auth/MfaChallenge/MfaChallenge.tsx +5 -2
  14. package/src/auth/MfaChallenge/block.meta.ts +1 -1
  15. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  16. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  17. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +5 -3
  18. package/src/auth/ResetPasswordForm/block.meta.ts +1 -1
  19. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  20. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  21. package/src/auth/SignInForm/SignInForm.tsx +5 -1
  22. package/src/auth/SignInForm/block.meta.ts +1 -1
  23. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  24. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  25. package/src/auth/SignUpForm/SignUpForm.tsx +7 -1
  26. package/src/auth/SignUpForm/block.meta.ts +1 -1
  27. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  28. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  29. package/src/auth/field-size.test.tsx +21 -0
  30. package/src/auth/large-examples.test.tsx +30 -0
  31. package/src/auth/shared.tsx +7 -2
  32. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  33. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  34. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  35. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  36. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  37. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  38. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  39. package/src/builders/FlowBuilder/parts.tsx +4 -4
  40. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  41. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  42. package/src/builders/LogViewer/LogViewer.tsx +67 -20
  43. package/src/builders/LogViewer/block.meta.ts +2 -1
  44. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  45. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  46. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  47. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  48. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  49. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  50. package/src/data-display/CommentThread/block.meta.ts +1 -1
  51. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  52. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +14 -20
  54. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  55. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +2 -1
  56. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  57. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  58. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  59. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  60. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  61. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  62. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  63. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  64. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  65. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  66. package/src/feedback/EmptyStates/EmptyStates.tsx +5 -3
  67. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  68. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  69. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  70. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  71. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +128 -139
  72. package/src/forms/CreateApiKeyDialog/block.meta.ts +12 -1
  73. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  74. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  75. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  76. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +267 -69
  77. package/src/forms/FileUploadPanel/block.meta.ts +5 -1
  78. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  79. package/src/forms/FileUploadPanel/examples/Labels.tsx +1 -1
  80. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  81. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  82. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  83. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  84. package/src/forms/FormSection/FormSection.tsx +20 -22
  85. package/src/forms/FormSection/block.meta.ts +1 -1
  86. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  87. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  88. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +90 -109
  89. package/src/forms/InviteMembersDialog/block.meta.ts +1 -1
  90. package/src/forms/ValidationSummary/ValidationSummary.tsx +1 -4
  91. package/src/hooks/index.ts +2 -0
  92. package/src/hooks/useTableData.integration.test.tsx +89 -0
  93. package/src/hooks/useTableData.test.tsx +613 -0
  94. package/src/hooks/useTableData.ts +377 -0
  95. package/src/index.ts +1 -0
  96. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  97. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  98. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  99. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  100. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  101. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  102. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  103. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  104. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  105. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  106. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  107. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  108. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  109. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  110. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  111. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  112. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  113. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  114. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  115. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  116. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  117. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  118. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  119. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  120. package/src/marketing/index.ts +6 -0
  121. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  122. package/src/page-chrome/PageHeader/PageHeader.tsx +4 -4
  123. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  124. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  125. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  126. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  127. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  128. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  129. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  130. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  132. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  133. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  134. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  136. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  137. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  138. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  139. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  140. package/src/scheduling/shared/dates.ts +102 -58
  141. package/src/scheduling/shared/events.ts +2 -2
  142. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  143. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  144. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  145. package/src/shell/AppSidebar/block.meta.ts +1 -1
  146. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  147. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  148. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  149. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  150. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  151. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  152. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  153. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +328 -14
  154. package/src/tables/DataTable/DataTable.test.tsx +85 -1
  155. package/src/tables/DataTable/DataTable.tsx +108 -14
  156. package/src/tables/DataTable/block.meta.ts +11 -1
  157. package/src/tables/DataTable/column-sizing.ts +2 -2
  158. package/src/tables/DataTable/data-table-props.ts +29 -1
  159. package/src/tables/DataTable/data-table-row.tsx +2 -2
  160. package/src/tables/DataTable/data-table-utils.ts +4 -0
  161. package/src/tables/DataTable/editable-cell.tsx +20 -79
  162. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  163. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  164. package/src/tables/DataTable/examples/server-pagination.tsx +47 -40
  165. package/src/tables/DataTable/export-menu.tsx +58 -0
  166. package/src/tables/DataTable/header-cell.tsx +1 -1
  167. package/src/tables/DataTable/labels.ts +7 -0
  168. package/src/tables/DataTable/resize-handle.tsx +2 -2
  169. package/src/tables/DataTable/use-table-export.ts +117 -0
  170. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  171. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  172. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  173. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  174. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  175. package/src/team/ProfileHeader/block.meta.ts +1 -1
  176. package/src/test/OptInDefaults.test.tsx +10 -1
  177. package/src/test/clipboard-fallback.test.tsx +49 -0
  178. package/src/test/copy-examples.test.tsx +29 -0
  179. package/src/test/copy-feedback.test.tsx +166 -0
  180. package/src/test/fixtures/opt-in-defaults.json +5 -5
  181. package/src/test/without-forced-colors.test.ts +44 -0
  182. 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;
@@ -389,7 +393,7 @@ export interface ForgotPasswordFormLabels extends Required<Omit<AuthValidationMe
389
393
  identifierPlaceholder: string;
390
394
  submit: string;
391
395
  }
392
- export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps {
396
+ export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps, AuthFieldSizeProps {
393
397
  labels?: Partial<ForgotPasswordFormLabels>;
394
398
  /** React 19 ref for focus after a server response; available in the request state. */
395
399
  ref?: Ref<ForgotPasswordFormRef>;
@@ -418,7 +422,7 @@ export interface ForgotPasswordFormProps extends AuthFormAccessibilityProps {
418
422
  className?: string;
419
423
  }
420
424
  /** Request a reset link by email, then a "check your inbox" state with resend and a way back. */
421
- export declare function ForgotPasswordForm({ labels, 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;
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;
422
426
  //#endregion
423
427
  //#region src/auth/ForgotPasswordForm/block.meta.d.ts
424
428
  declare const meta$30: BlockMeta;
@@ -447,7 +451,7 @@ export interface MfaChallengeLabels {
447
451
  backToSignIn: string;
448
452
  fallbackError: string;
449
453
  }
450
- export interface MfaChallengeProps {
454
+ export interface MfaChallengeProps extends AuthFieldSizeProps {
451
455
  labels?: Partial<MfaChallengeLabels>;
452
456
  /** Verifies the code. A returned promise shows the loading state; a rejection shows in the alert. */
453
457
  onVerify?: (code: string, method: MfaMethod) => void | Promise<void>;
@@ -473,10 +477,10 @@ export interface MfaChallengeProps {
473
477
  * Second-factor step: a one-time code (auto-submits when complete), a switch to a backup code,
474
478
  * and a resend button with a countdown.
475
479
  */
476
- export declare function MfaChallenge({ labels, onVerify, onResend, resendCooldown, initialCooldown, length, destination, error: errorProp, loading: loadingProp, onCancel, eyebrow: eyebrowProp, title: titleProp, 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;
477
481
  //#endregion
478
482
  //#region src/auth/MfaChallenge/block.meta.d.ts
479
- declare const meta$42: BlockMeta;
483
+ declare const meta$43: BlockMeta;
480
484
  //#endregion
481
485
  //#region src/auth/ResetPasswordForm/ResetPasswordForm.d.ts
482
486
  export interface ResetPasswordFormLabels {
@@ -494,7 +498,7 @@ export interface ResetPasswordFormLabels {
494
498
  continue: string;
495
499
  fallbackError: string;
496
500
  }
497
- export interface ResetPasswordFormProps {
501
+ export interface ResetPasswordFormProps extends AuthFieldSizeProps {
498
502
  labels?: Partial<ResetPasswordFormLabels>;
499
503
  /** Saves the new password. A returned promise shows the loading state; a rejection shows in the alert. */
500
504
  onSubmit?: (password: string) => void | Promise<void>;
@@ -506,10 +510,10 @@ export interface ResetPasswordFormProps {
506
510
  className?: string;
507
511
  }
508
512
  /** New password + confirmation with length and mismatch validation, then a success state. */
509
- export declare function ResetPasswordForm({ labels, onSubmit, error: errorProp, minPasswordLength, onContinue, eyebrow: eyebrowProp, 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;
510
514
  //#endregion
511
515
  //#region src/auth/ResetPasswordForm/block.meta.d.ts
512
- declare const meta$57: BlockMeta;
516
+ declare const meta$58: BlockMeta;
513
517
  //#endregion
514
518
  //#region src/auth/SignInForm/SignInForm.d.ts
515
519
  export interface SignInValues {
@@ -539,7 +543,7 @@ export interface SignInFormLabels extends Required<AuthValidationMessages> {
539
543
  signUp: string;
540
544
  fallbackError: string;
541
545
  }
542
- export interface SignInFormProps extends AuthFormAccessibilityProps {
546
+ export interface SignInFormProps extends AuthFormAccessibilityProps, AuthFieldSizeProps {
543
547
  labels?: Partial<SignInFormLabels>;
544
548
  /** React 19 ref for focus after a server response. */
545
549
  ref?: Ref<SignInFormRef>;
@@ -571,10 +575,10 @@ export interface SignInFormProps extends AuthFormAccessibilityProps {
571
575
  className?: string;
572
576
  }
573
577
  /** Email + password sign-in with remember me, forgot-password link, SSO slot, error alert and loading. */
574
- export declare function SignInForm({ labels, 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;
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;
575
579
  //#endregion
576
580
  //#region src/auth/SignInForm/block.meta.d.ts
577
- declare const meta$62: BlockMeta;
581
+ declare const meta$63: BlockMeta;
578
582
  //#endregion
579
583
  //#region src/auth/SignUpForm/SignUpForm.d.ts
580
584
  export interface SignUpValues {
@@ -607,7 +611,7 @@ export interface SignUpFormLabels extends AuthSignUpFieldLabels {
607
611
  fallbackError: string;
608
612
  emailInvalid: string;
609
613
  }
610
- export interface SignUpFormProps {
614
+ export interface SignUpFormProps extends AuthFieldSizeProps {
611
615
  labels?: Partial<SignUpFormLabels>;
612
616
  /** Ordered text/email inputs before Password. Omit to keep the default fields and payload. */
613
617
  fields?: readonly AuthSignUpField[];
@@ -638,10 +642,10 @@ export interface SignUpFormProps {
638
642
  className?: string;
639
643
  }
640
644
  /** Account creation: name, work email, password with a strength meter and a required terms checkbox. */
641
- export declare function SignUpForm({ labels, 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;
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;
642
646
  //#endregion
643
647
  //#region src/auth/SignUpForm/block.meta.d.ts
644
- declare const meta$63: BlockMeta;
648
+ declare const meta$64: BlockMeta;
645
649
  //#endregion
646
650
  //#region src/auth/SsoButtons/fixtures.d.ts
647
651
  interface SsoProvider {
@@ -675,7 +679,7 @@ export interface SsoButtonsProps {
675
679
  export declare function SsoButtons({ labels, providers, onSelect, loadingId, disabled, layout, label: labelProp, className }: SsoButtonsProps): import("react").JSX.Element;
676
680
  //#endregion
677
681
  //#region src/auth/SsoButtons/block.meta.d.ts
678
- declare const meta$66: BlockMeta;
682
+ declare const meta$68: BlockMeta;
679
683
  //#endregion
680
684
  //#region src/billing/format.d.ts
681
685
  /** Shared formatting for the billing blocks (en-US, Intl). */
@@ -744,7 +748,7 @@ export type PlanCardProps = BillingPlanCardProps | PlanSummaryProps;
744
748
  export declare function PlanCard(props: PlanCardProps): import("react").JSX.Element;
745
749
  //#endregion
746
750
  //#region src/billing/PlanCard/block.meta.d.ts
747
- declare const meta$51: BlockMeta;
751
+ declare const meta$52: BlockMeta;
748
752
  //#endregion
749
753
  //#region src/billing/PlanCard/fixtures.d.ts
750
754
  /** Sample current plan (neutral workspace data). */
@@ -775,7 +779,7 @@ export interface PlanDefinitionCardProps {
775
779
  export declare function PlanDefinitionCard({ plan, density, actions, statusLabels, titleAs: TitleTag, className }: PlanDefinitionCardProps): import("react").JSX.Element;
776
780
  //#endregion
777
781
  //#region src/billing/PlanDefinitionCard/block.meta.d.ts
778
- declare const meta$52: BlockMeta;
782
+ declare const meta$53: BlockMeta;
779
783
  //#endregion
780
784
  //#region src/billing/PlanDefinitionCard/fixtures.d.ts
781
785
  export declare const samplePlanDefinition: PlanDefinition;
@@ -812,7 +816,7 @@ export interface QuotaMetersProps {
812
816
  export declare function QuotaMeters({ quotas, title, thresholds, formatValue, defaultScope, onScopeChange, titleAs: TitleTag, className }: QuotaMetersProps): import("react").JSX.Element;
813
817
  //#endregion
814
818
  //#region src/billing/QuotaMeters/block.meta.d.ts
815
- declare const meta$56: BlockMeta;
819
+ declare const meta$57: BlockMeta;
816
820
  //#endregion
817
821
  //#region src/billing/QuotaMeters/fixtures.d.ts
818
822
  /** Sample plan quotas: usage so far this cycle and the end-of-cycle projection. */
@@ -845,7 +849,7 @@ export interface SpendVsBudgetProps {
845
849
  export declare function SpendVsBudget({ data, budget, currency, title, period, height, titleAs: TitleTag, className }: SpendVsBudgetProps): import("react").JSX.Element;
846
850
  //#endregion
847
851
  //#region src/billing/SpendVsBudget/block.meta.d.ts
848
- declare const meta$65: BlockMeta;
852
+ declare const meta$67: BlockMeta;
849
853
  //#endregion
850
854
  //#region src/billing/SpendVsBudget/fixtures.d.ts
851
855
  /**
@@ -920,7 +924,7 @@ export interface PaymentMethodCardProps {
920
924
  export declare function PaymentMethodCard({ method, title, description, onUpdate, onRemove, updateLabel, titleAs, className }: PaymentMethodCardProps): import("react").JSX.Element;
921
925
  //#endregion
922
926
  //#region src/billing/PaymentMethodCard/block.meta.d.ts
923
- declare const meta$49: BlockMeta;
927
+ declare const meta$50: BlockMeta;
924
928
  //#endregion
925
929
  //#region src/billing/PaymentMethodCard/fixtures.d.ts
926
930
  /** Sample default payment method. */
@@ -1187,6 +1191,7 @@ export interface LogViewerLabels {
1187
1191
  inspect: (timestamp: string) => string;
1188
1192
  copy: (timestamp: string) => string;
1189
1193
  copied: string;
1194
+ copyFailed?: string;
1190
1195
  }
1191
1196
  export interface LogViewerProps {
1192
1197
  /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
@@ -1272,12 +1277,14 @@ export interface KpiRowProps {
1272
1277
  /** Accessible name of the list. */
1273
1278
  label?: string;
1274
1279
  className?: string;
1280
+ /** Styles the container wrapper, including placement in a parent grid. */
1281
+ containerClassName?: string;
1275
1282
  }
1276
1283
  /**
1277
1284
  * KPI row: label, big number, delta (direction and sentiment are independent) and an optional
1278
1285
  * Sparkline. A description list, so each label is announced with its value.
1279
1286
  */
1280
- 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;
1281
1288
  //#endregion
1282
1289
  //#region src/data-display/KpiRow/block.meta.d.ts
1283
1290
  declare const meta$38: BlockMeta;
@@ -1326,7 +1333,7 @@ export interface StatCardProps {
1326
1333
  export declare function StatCard({ label, icon: IconCmp, ranges, defaultRange, range: rangeProp, onRangeChange, chart, tone, action, titleAs: TitleTag, className }: StatCardProps): import("react").JSX.Element;
1327
1334
  //#endregion
1328
1335
  //#region src/data-display/StatCard/block.meta.d.ts
1329
- declare const meta$67: BlockMeta;
1336
+ declare const meta$69: BlockMeta;
1330
1337
  //#endregion
1331
1338
  //#region src/data-display/StatCard/fixtures.d.ts
1332
1339
  /** Requests per range: the value and delta recalculate when the range changes. */
@@ -1446,6 +1453,7 @@ export interface DescriptionListCardLabels {
1446
1453
  copy: (label: string) => string;
1447
1454
  copied: (label: string) => string;
1448
1455
  copiedToClipboard: string;
1456
+ copyFailed?: string;
1449
1457
  }
1450
1458
  export interface DescriptionListCardProps {
1451
1459
  /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
@@ -1505,17 +1513,19 @@ export interface ResourceCardGridProps {
1505
1513
  onAction?: (action: ResourceAction, item: ResourceCard) => void;
1506
1514
  /** Replaces the default menu entirely. Return an empty array to hide the menu. */
1507
1515
  getActions?: (item: ResourceCard) => Array<MoreMenuAction | 'separator'>;
1508
- /** Columns at the widest breakpoint. */
1516
+ /** Maximum columns, chosen from this block's container width. */
1509
1517
  columns?: 2 | 3 | 4;
1510
1518
  /** Heading level of each card's name, to fit the page outline (default h3). */
1511
1519
  titleAs?: 'h2' | 'h3' | 'h4';
1512
1520
  className?: string;
1521
+ /** Styles the container wrapper, including placement in a parent grid. */
1522
+ containerClassName?: string;
1513
1523
  }
1514
1524
  /** Responsive grid of resource cards: icon or avatar, name, status, meta figures and a row-actions MoreMenu. */
1515
- 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;
1516
1526
  //#endregion
1517
1527
  //#region src/data-display/ResourceCardGrid/block.meta.d.ts
1518
- declare const meta$58: BlockMeta;
1528
+ declare const meta$59: BlockMeta;
1519
1529
  //#endregion
1520
1530
  //#region src/data-display/ResourceCardGrid/fixtures.d.ts
1521
1531
  /** Project resources. */
@@ -1558,7 +1568,7 @@ export interface StatusTimelineProps {
1558
1568
  export declare function StatusTimeline({ events, label: labelProp, emptyLabel: emptyLabelProp, showFewerLabel: showFewerLabelProp, showEarlierLabel: showEarlierLabelProp, actorLabel: actorLabelProp, maxVisible, timeFormat, className }: StatusTimelineProps): import("react").JSX.Element;
1559
1569
  //#endregion
1560
1570
  //#region src/data-display/StatusTimeline/block.meta.d.ts
1561
- declare const meta$68: BlockMeta;
1571
+ declare const meta$70: BlockMeta;
1562
1572
  //#endregion
1563
1573
  //#region src/data-display/StatusTimeline/fixtures.d.ts
1564
1574
  /** State changes of a deployment, newest first. */
@@ -1617,12 +1627,18 @@ export interface CommentAuthor {
1617
1627
  export interface ThreadComment {
1618
1628
  id: string;
1619
1629
  author: CommentAuthor;
1620
- /** Plain text (no markdown); line breaks are kept. */
1630
+ /** Plain text by default, with line breaks kept; pass renderBody to render Markdown. */
1621
1631
  body: string;
1622
1632
  at: DateInput;
1623
1633
  }
1624
1634
  export interface CommentThreadProps {
1625
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;
1626
1642
  /** Author of new comments (the signed-in user). */
1627
1643
  currentUser?: CommentAuthor;
1628
1644
  /** Called with the trimmed text when a comment is posted. */
@@ -1633,10 +1649,12 @@ export interface CommentThreadProps {
1633
1649
  label?: string;
1634
1650
  placeholder?: string;
1635
1651
  submitLabel?: string;
1652
+ /** Overrides the plain-text or Markdown hint; stays the composer's accessible description. */
1653
+ composerHint?: ReactNode;
1636
1654
  className?: string;
1637
1655
  }
1638
- /** Comment thread: avatar, author, plain-text body and Timestamp, with a reply composer (⌘/Ctrl+Enter posts). */
1639
- 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;
1640
1658
  //#endregion
1641
1659
  //#region src/data-display/CommentThread/block.meta.d.ts
1642
1660
  declare const meta$9: BlockMeta;
@@ -1681,7 +1699,7 @@ export interface SystemBannerProps {
1681
1699
  export declare function SystemBanner({ kind, title, message, action, dismissible, open, onDismiss, className }: SystemBannerProps): import("react").JSX.Element | null;
1682
1700
  //#endregion
1683
1701
  //#region src/feedback/SystemBanner/block.meta.d.ts
1684
- declare const meta$71: BlockMeta;
1702
+ declare const meta$73: BlockMeta;
1685
1703
  //#endregion
1686
1704
  //#region src/feedback/InlineCallout/InlineCallout.d.ts
1687
1705
  export interface InlineCalloutLabels {
@@ -1740,7 +1758,8 @@ export interface FirstRunEmptyProps extends SharedEmptyProps {
1740
1758
  icon?: LucideIcon;
1741
1759
  title?: ReactNode;
1742
1760
  description?: ReactNode;
1743
- actionLabel?: string;
1761
+ /** Omit to use labels.action or the localized default. `null` or "" hides the action; onAction is ignored. */
1762
+ actionLabel?: string | null;
1744
1763
  onAction?: () => void;
1745
1764
  /** Secondary link (docs, guide). `null` hides it. */
1746
1765
  secondary?: {
@@ -1852,7 +1871,7 @@ export interface PageSkeletonProps {
1852
1871
  export declare function PageSkeleton({ stats, rows, label: labelProp, className }: PageSkeletonProps): import("react").JSX.Element;
1853
1872
  //#endregion
1854
1873
  //#region src/feedback/Skeletons/block.meta.d.ts
1855
- declare const meta$64: BlockMeta;
1874
+ declare const meta$66: BlockMeta;
1856
1875
  //#endregion
1857
1876
  //#region src/feedback/ConfirmDestructive/ConfirmDestructive.d.ts
1858
1877
  export type ConfirmDestructiveFailure = {
@@ -2067,7 +2086,7 @@ export interface CreateApiKeyDialogProps {
2067
2086
  * Two-step API key dialog: name, scopes and expiry, then the secret shown once in a CodeBlock
2068
2087
  * with copy. Closing the dialog discards the secret; it can't be shown again.
2069
2088
  */
2070
- export declare function CreateApiKeyDialog({ labels, 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;
2071
2090
  //#endregion
2072
2091
  //#region src/forms/CreateApiKeyDialog/block.meta.d.ts
2073
2092
  declare const meta$13: BlockMeta;
@@ -2183,9 +2202,11 @@ export declare function DateRangeFilter({ labels, value, defaultValue, onValueCh
2183
2202
  declare const meta$18: BlockMeta;
2184
2203
  //#endregion
2185
2204
  //#region src/forms/FileUploadPanel/fixtures.d.ts
2186
- type UploadStatus = 'uploading' | 'done' | 'error';
2205
+ type UploadStatus = 'pending' | 'uploading' | 'done' | 'error';
2187
2206
  interface UploadItem {
2188
2207
  id: string;
2208
+ /** Picked source file, absent for previously uploaded items. */
2209
+ file?: File;
2189
2210
  name: string;
2190
2211
  /** Size in bytes. */
2191
2212
  size: number;
@@ -2197,7 +2218,10 @@ interface UploadItem {
2197
2218
  }
2198
2219
  export declare const uploadItems: UploadItem[];
2199
2220
  /** Demo uploader: reports progress in steps and resolves after ~1.5 s. */
2200
- 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>;
2201
2225
  //#endregion
2202
2226
  //#region src/forms/FileUploadPanel/FileUploadPanel.d.ts
2203
2227
  export interface FileUploadPanelLabels {
@@ -2219,6 +2243,14 @@ export interface FileUploadPanelLabels {
2219
2243
  uploaded: (size: string) => string;
2220
2244
  retry: (name: string) => string;
2221
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[];
2222
2254
  }
2223
2255
  export interface FileUploadPanelProps {
2224
2256
  labels?: Partial<FileUploadPanelLabels>;
@@ -2229,9 +2261,20 @@ export interface FileUploadPanelProps {
2229
2261
  multiple?: boolean;
2230
2262
  /** Initial list (e.g. files already uploaded). */
2231
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>;
2232
2271
  /** Uploads one file and reports progress (0–100). Defaults to a demo simulation. */
2233
- onUpload?: (file: File, onProgress: (pct: number) => void) => Promise<void>;
2234
- 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>;
2235
2278
  /** Visible label of the panel. */
2236
2279
  label?: string;
2237
2280
  /** Hint under the drop text; defaults to the accepted types and size limit. */
@@ -2243,7 +2286,7 @@ export interface FileUploadPanelProps {
2243
2286
  * Drop zone with a Browse button, accept and size validation, and a file list with progress,
2244
2287
  * retry and remove. Rejected files stay in the list with the reason.
2245
2288
  */
2246
- export declare function FileUploadPanel({ labels, 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;
2247
2290
  //#endregion
2248
2291
  //#region src/forms/FileUploadPanel/block.meta.d.ts
2249
2292
  declare const meta$27: BlockMeta;
@@ -2271,7 +2314,7 @@ export interface FormSectionProps extends Omit<HTMLAttributes<HTMLElement>, 'tit
2271
2314
  }
2272
2315
  /**
2273
2316
  * Two-column form section: title and help on the left, fields on the right. Stacks into a
2274
- * single column on small screens.
2317
+ * single column in narrow containers.
2275
2318
  */
2276
2319
  export declare function FormSection({ labels, title: titleProp, description: descriptionProp, children, actions, headingLevel: Heading, divided, className, ...props }: FormSectionProps): import("react").JSX.Element;
2277
2320
  //#endregion
@@ -2327,7 +2370,7 @@ export interface InviteMembersDialogProps {
2327
2370
  description?: string;
2328
2371
  }
2329
2372
  /** Invite dialog: email chips with validation, a role and an optional message; submit with loading. */
2330
- export declare function InviteMembersDialog({ labels, roles, defaultRole, onInvite, maxInvites, open: openProp, defaultOpen, onOpenChange, trigger, title: titleProp, description: descriptionProp }: 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;
2331
2374
  //#endregion
2332
2375
  //#region src/forms/InviteMembersDialog/block.meta.d.ts
2333
2376
  declare const meta$36: BlockMeta;
@@ -2364,7 +2407,7 @@ export interface SettingsRowProps {
2364
2407
  export declare function SettingsRow({ labels, label: labelProp, description: descriptionProp, control, checked, defaultChecked, onCheckedChange, disabled, children, className }: SettingsRowProps): import("react").JSX.Element;
2365
2408
  //#endregion
2366
2409
  //#region src/forms/SettingsRow/block.meta.d.ts
2367
- declare const meta$61: BlockMeta;
2410
+ declare const meta$62: BlockMeta;
2368
2411
  //#endregion
2369
2412
  //#region src/forms/ValidationSummary/fixtures.d.ts
2370
2413
  interface ValidationIssue {
@@ -2444,1241 +2487,1507 @@ export declare const dialogWizardCopy: {
2444
2487
  };
2445
2488
  //#endregion
2446
2489
  //#region src/forms/ValidationSummary/block.meta.d.ts
2447
- declare const meta$76: BlockMeta;
2448
- //#endregion
2449
- //#region src/marketing/actions.d.ts
2450
- type IconComponent = ComponentType<{
2451
- size?: number;
2452
- 'aria-hidden'?: boolean;
2453
- }>;
2454
- /** A call to action: a link when `href` is set, otherwise a button. */
2455
- interface MarketingAction {
2456
- label: string;
2457
- href?: string;
2458
- onClick?: () => void;
2459
- /** Trailing icon (lucide component). */
2460
- icon?: IconComponent;
2461
- }
2462
- //#endregion
2463
- //#region src/marketing/Hero/Hero.d.ts
2464
- export interface HeroProps {
2465
- /** `centered` (copy over the media) or `split` (copy left, media right from `lg`). */
2466
- variant?: 'centered' | 'split';
2467
- /** Small label above the title. */
2468
- eyebrow?: ReactNode;
2469
- title?: ReactNode;
2470
- description?: ReactNode;
2471
- primaryAction?: MarketingAction | null;
2472
- secondaryAction?: MarketingAction | null;
2473
- /** Screenshot slot. Defaults to a neutral app-window placeholder; null hides it. */
2474
- media?: ReactNode;
2475
- /** Heading level of the title. */
2476
- headingLevel?: 'h1' | 'h2';
2477
- className?: string;
2478
- }
2479
- /** Neutral app-window placeholder for the screenshot slot (decorative). */
2480
- export declare function HeroScreenshotPlaceholder({ className }: {
2481
- className?: string;
2482
- }): import("react").JSX.Element;
2483
- /** Landing hero: eyebrow, title, description, two calls to action and a screenshot slot. */
2484
- export declare function Hero({ variant, eyebrow, title, description, primaryAction, secondaryAction, media, headingLevel: Heading, className }: HeroProps): import("react").JSX.Element;
2485
- //#endregion
2486
- //#region src/marketing/Hero/block.meta.d.ts
2487
- declare const meta$33: BlockMeta;
2488
- //#endregion
2489
- //#region src/marketing/FeatureGrid/FeatureGrid.d.ts
2490
- export interface Feature {
2491
- icon: LucideIcon;
2492
- title: string;
2493
- description: ReactNode;
2494
- }
2495
- export interface FeatureGridProps {
2496
- features?: Feature[];
2497
- eyebrow?: ReactNode;
2498
- title?: ReactNode;
2499
- description?: ReactNode;
2500
- /** Columns from `lg` (one column on phones, two on tablets). */
2501
- columns?: 2 | 3 | 4;
2502
- /** Heading level of the section title; feature titles use the next level. */
2503
- headingLevel?: 'h2' | 'h3';
2504
- className?: string;
2505
- }
2506
- /** Features section: a heading block over a grid of icon + title + description. */
2507
- export declare function FeatureGrid({ features, eyebrow, title, description, columns, headingLevel: Heading, className }: FeatureGridProps): import("react").JSX.Element;
2508
- //#endregion
2509
- //#region src/marketing/FeatureGrid/block.meta.d.ts
2510
- declare const meta$26: BlockMeta;
2511
- //#endregion
2512
- //#region src/marketing/FeatureGrid/fixtures.d.ts
2513
- /** Sample product-agnostic features. */
2514
- export declare const sampleFeatures: Feature[];
2490
+ declare const meta$78: BlockMeta;
2515
2491
  //#endregion
2516
- //#region src/marketing/PricingTable/PricingTable.d.ts
2517
- export type PricingCycle = 'monthly' | 'annual';
2518
- export interface PricingTier {
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). */
2519
2511
  id: string;
2520
- name: string;
2521
- description?: string;
2522
- /** Price per month on monthly billing; null shows "Custom". */
2523
- priceMonthly: number | null;
2524
- /** Price per month on annual billing; null shows "Custom". */
2525
- priceAnnual: number | null;
2526
- /** Call-to-action label. */
2527
- cta: string;
2528
- features: string[];
2529
- /** Emphasised with a primary border (no colour fill). */
2530
- highlighted?: boolean;
2531
- /** Label on the tier, e.g. "Most popular". */
2532
- badge?: string;
2533
- }
2534
- export interface PricingTableProps {
2535
- tiers?: PricingTier[];
2536
- eyebrow?: ReactNode;
2537
- title?: ReactNode;
2538
- description?: ReactNode;
2539
- currency?: string;
2540
- defaultCycle?: PricingCycle;
2541
- onCycleChange?: (cycle: PricingCycle) => void;
2542
- /** Called with the tier and the cycle shown when a CTA is activated. */
2543
- onSelectTier?: (tier: PricingTier, cycle: PricingCycle) => void;
2544
- /** Note next to the annual option, e.g. "Save 20%". */
2545
- annualNote?: string;
2546
- /** Level of the section title; tier names use the next level (or this one when there is no title). */
2547
- headingLevel?: 'h2' | 'h3';
2548
- /** Shows the monthly/annual toggle (default true). */
2549
- showCycleToggle?: boolean;
2550
- /** Columns at the widest breakpoint (default: one per tier, up to 4). */
2551
- columns?: 1 | 2 | 3 | 4;
2552
- /** Names the tier list / radio group when `title` is null (the block then renders no landmark), e.g. inside a wizard step. */
2553
- 'aria-label'?: string;
2554
- /** Id of an external heading that names the section when `title` is null. */
2555
- 'aria-labelledby'?: string;
2556
- /**
2557
- * Id of the tier the account is on: its card gets a "Current plan" badge and
2558
- * `aria-current`, and its CTA becomes a disabled "Current plan" button.
2559
- */
2560
- currentTierId?: string;
2561
- /** Label of the current tier's badge and disabled CTA. */
2562
- currentPlanLabel?: 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;
2563
2528
  /**
2564
- * Turns the tiers into a single-choice radio group (role radiogroup/radio, arrow keys,
2565
- * selected card with a primary border and a check). CTAs are not rendered in this mode.
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).
2566
2531
  */
2567
- selectable?: boolean;
2568
- /** Selected tier id (controlled, `selectable` only). */
2569
- value?: string;
2570
- /** Initially selected tier id (uncontrolled, `selectable` only). */
2571
- defaultValue?: string;
2572
- /** Called with the newly selected tier id (`selectable` only). */
2573
- onValueChange?: (value: string) => void;
2532
+ variant?: DataTableColumnVariant;
2533
+ /** Classes for the body cells (merged after the variant's). */
2574
2534
  className?: string;
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;
2575
2553
  }
2576
- /** Pricing section: tiers with a monthly/annual toggle, a highlighted tier and a feature checklist. */
2577
- 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;
2578
- //#endregion
2579
- //#region src/marketing/PricingTable/block.meta.d.ts
2580
- declare const meta$53: BlockMeta;
2581
- //#endregion
2582
- //#region src/marketing/PricingTable/fixtures.d.ts
2583
- /** Sample three-tier pricing. Prices are per month; annual is per month billed yearly. */
2584
- export declare const samplePricingTiers: PricingTier[];
2585
- //#endregion
2586
- //#region src/marketing/Faq/Faq.d.ts
2587
- export interface FaqItem {
2588
- id: string;
2589
- question: string;
2590
- answer: ReactNode;
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;
2591
2573
  }
2592
- export interface FaqProps {
2593
- items?: FaqItem[];
2594
- title?: ReactNode;
2595
- description?: ReactNode;
2596
- /** `stacked` (heading over the list) or `split` (heading left from `lg`). */
2597
- layout?: 'stacked' | 'split';
2598
- /** Ids of the items open on mount. */
2599
- defaultOpen?: string[];
2600
- /** Allow several items open at once. */
2601
- multiple?: boolean;
2602
- headingLevel?: 'h2' | 'h3';
2603
- className?: string;
2604
- }
2605
- /** Frequently asked questions in an accordion, with a heading block. */
2606
- export declare function Faq({ items, title, description, layout, defaultOpen, multiple, headingLevel: Heading, className }: FaqProps): import("react").JSX.Element;
2607
- //#endregion
2608
- //#region src/marketing/Faq/block.meta.d.ts
2609
- declare const meta$25: BlockMeta;
2610
- //#endregion
2611
- //#region src/marketing/Faq/fixtures.d.ts
2612
- /** Sample product-agnostic questions. */
2613
- export declare const sampleFaqs: FaqItem[];
2614
- //#endregion
2615
- //#region src/marketing/ComparisonTable/ComparisonTable.d.ts
2616
- /** A plan or option: one column of the comparison. */
2617
- export interface ComparisonPlan {
2618
- id: string;
2619
- name: string;
2620
- /** Headline price or figure under the name ("$49", "Custom"). */
2621
- price?: ReactNode;
2622
- /** Small text after the price ("per month"). */
2623
- priceNote?: ReactNode;
2624
- /** Call to action under the price. */
2625
- cta?: MarketingAction;
2626
- }
2627
- /** A plain value, or a value with a short note under it ("Add-on"). */
2628
- export type ComparisonValue = boolean | string | number | null | undefined | {
2629
- value: boolean | string | number | null;
2630
- note?: 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;
2631
2586
  };
2632
- export interface ComparisonFeature {
2633
- id: string;
2634
- label: string;
2635
- /** Muted text under the label. */
2636
- description?: string;
2637
- /** Value per plan id. Missing / null values render like `false` (a dash, "Not included"). */
2638
- values: Readonly<Record<string, ComparisonValue>>;
2639
- }
2640
- export interface ComparisonSection {
2641
- id: string;
2642
- title: string;
2643
- features: ComparisonFeature[];
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];
2644
2594
  }
2645
- export interface ComparisonTableProps {
2646
- plans?: ComparisonPlan[];
2647
- sections?: ComparisonSection[];
2648
- /** Plan column marked as recommended: badge text, a primary top rule and a tinted column. */
2649
- highlightedPlanId?: string;
2650
- /** Text of the recommended badge (default "Recommended"). */
2651
- highlightLabel?: string;
2652
- eyebrow?: ReactNode;
2653
- title?: ReactNode;
2654
- description?: ReactNode;
2655
- /** Level of the section title (default h2). */
2656
- headingLevel?: 'h2' | 'h3';
2657
- /** Table name (screen-reader caption). Default: the title when it is a string, else "Plan comparison". */
2658
- caption?: string;
2659
- /** Header of the feature column (screen-reader only unless `showFeatureHeader`). */
2660
- featureHeader?: string;
2661
- showFeatureHeader?: boolean;
2662
- /** Screen-reader text of `true` (default "Included"). */
2663
- includedLabel?: string;
2664
- /** Screen-reader text of `false` / missing values (default "Not included"). */
2665
- notIncludedLabel?: string;
2666
- /** Formats numeric values (default: en-US grouping). */
2667
- formatNumber?: (value: number, feature: ComparisonFeature) => string;
2668
- 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[];
2669
2604
  }
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;
2670
2607
  /**
2671
- * Feature comparison of plans or options: columns are plans, rows are features grouped by section.
2672
- * Booleans render as a check or a dash with screen-reader text; text and numbers render as is. The
2673
- * table scrolls sideways on narrow screens with the feature column pinned.
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.
2674
2610
  */
2675
- 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;
2676
- //#endregion
2677
- //#region src/marketing/ComparisonTable/block.meta.d.ts
2678
- declare const meta$10: BlockMeta;
2679
- //#endregion
2680
- //#region src/marketing/ComparisonTable/fixtures.d.ts
2681
- /** Three sample plans (generic, product-agnostic). */
2682
- export declare const sampleComparisonPlans: ComparisonPlan[];
2683
- /** Features grouped by section; values are keyed by plan id. */
2684
- export declare const sampleComparisonSections: ComparisonSection[];
2611
+ export declare function groupRows<T>(rows: readonly T[], groupBy: DataTableGroupBy<T>, order?: readonly T[]): DataTableGroup<T>[];
2685
2612
  //#endregion
2686
- //#region src/page-chrome/types.d.ts
2687
- /** A header/toolbar action rendered as a kit Button (or a MoreMenu item when folded). */
2688
- interface PageChromeAction {
2689
- /** Stable key; defaults to `label`. */
2690
- id?: string;
2691
- label: string;
2692
- icon?: LucideIcon;
2693
- /** Button style; when omitted the block picks one (primary for the main action, secondary otherwise). */
2694
- variant?: ButtonProps['variant'];
2695
- disabled?: boolean;
2696
- onClick?: () => void;
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[];
2697
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>>;
2698
2633
  //#endregion
2699
- //#region src/page-chrome/PageHeader/PageHeader.d.ts
2700
- export interface PageHeaderMetaItem {
2701
- /** Term (screen-reader only when an icon is shown). */
2702
- label: string;
2703
- value: ReactNode;
2704
- icon?: LucideIcon;
2705
- /** Render the value in Geist Mono (ids, regions, versions). */
2706
- mono?: boolean;
2707
- }
2708
- export interface PageHeaderTab {
2709
- value: string;
2710
- label: string;
2711
- count?: number;
2712
- }
2713
- export interface PageHeaderLabels {
2714
- title: string;
2715
- description: string;
2716
- moreActions: string;
2717
- sections: string;
2718
- }
2719
- export interface PageHeaderProps {
2720
- /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
2721
- labels?: Partial<PageHeaderLabels>;
2722
- /** Root element. Use 'div' where the layout already has a banner (e.g. StackedLayout's pageHeader slot). */
2723
- as?: 'header' | 'div';
2724
- /** Location trail above the title; `null` hides it. */
2725
- breadcrumbs?: BreadcrumbItem[] | null;
2726
- title?: ReactNode;
2727
- /** Wrap the title, including long unbroken words, instead of truncating (default false). */
2728
- wrapTitle?: boolean;
2729
- /** h1 focus target: adds tabIndex=-1 for titleRef.current.focus(), outside the Tab order. */
2730
- titleRef?: Ref<HTMLHeadingElement>;
2731
- description?: ReactNode;
2732
- /** StatusTag key next to the title (e.g. `active`, `paused`, `failed`). */
2733
- status?: string;
2734
- statuses?: Record<string, StatusDefinition>;
2735
- /** Meta row under the description. */
2736
- meta?: PageHeaderMetaItem[];
2737
- /**
2738
- * Header actions in visual order. The primary one (first with `variant: 'primary'`, else the
2739
- * last) stays visible on small screens; the rest fold into a MoreMenu.
2740
- */
2741
- actions?: PageChromeAction[];
2742
- /** Resource-level navigation tabs under the header; `null` hides them. */
2743
- tabs?: PageHeaderTab[] | null;
2744
- tab?: string;
2745
- defaultTab?: string;
2746
- onTabChange?: (value: string) => void;
2747
- className?: string;
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;
2748
2643
  }
2749
- /** Screen header: breadcrumb, title + status, description, meta row, actions and optional tabs. */
2750
- 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;
2751
- //#endregion
2752
- //#region src/page-chrome/PageHeader/fixtures.d.ts
2753
- export declare const pageHeaderBreadcrumbs: BreadcrumbItem[];
2754
- export declare const pageHeaderActions: PageChromeAction[];
2755
- export declare const pageHeaderTabs: PageHeaderTab[];
2756
- //#endregion
2757
- //#region src/page-chrome/PageHeader/block.meta.d.ts
2758
- declare const meta$46: BlockMeta;
2759
- //#endregion
2760
- //#region src/page-chrome/SectionHeader/SectionHeader.d.ts
2761
- export interface SectionHeaderProps {
2762
- title?: ReactNode;
2763
- description?: ReactNode;
2764
- /** Count pill after the title (members, items…). */
2765
- count?: number;
2766
- /** Small actions on the right; the last one without a variant is secondary. */
2767
- actions?: PageChromeAction[];
2768
- /** Heading level that fits the page outline. */
2769
- as?: 'h2' | 'h3';
2770
- /** Hairline under the header. */
2771
- bordered?: boolean;
2772
- /** Id for the heading, so a section can use `aria-labelledby`. */
2773
- headingId?: string;
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;
2774
2661
  className?: string;
2775
2662
  }
2776
- /** Heading for a section inside a page: title (+ count), description and small actions. */
2777
- export declare function SectionHeader({ title, description, count, actions, as: Heading, bordered, headingId, className }: SectionHeaderProps): import("react").JSX.Element;
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;
2778
2665
  //#endregion
2779
- //#region src/page-chrome/SectionHeader/block.meta.d.ts
2780
- declare const meta$59: BlockMeta;
2781
- //#endregion
2782
- //#region src/page-chrome/PageToolbar/PageToolbar.d.ts
2783
- export interface PageToolbarView {
2784
- value: string;
2785
- /** Accessible name of the icon toggle. */
2786
- label: string;
2787
- icon: LucideIcon;
2788
- }
2789
- export interface PageToolbarProps {
2790
- /** Controlled search text. */
2791
- search?: string;
2792
- defaultSearch?: string;
2793
- onSearchChange?: (value: string) => void;
2794
- searchLabel?: string;
2795
- searchPlaceholder?: string;
2796
- /**
2797
- * Filter controls. Use ToolbarButton (optionally with `render` for a Menu/Popover trigger) so they
2798
- * join the toolbar's arrow-key navigation. Omitted: a single "Filters" button; `null` hides it.
2799
- */
2800
- filters?: ReactNode;
2801
- /** View modes for the segmented toggle; `null` or an empty list hides it. */
2802
- views?: PageToolbarView[] | null;
2803
- view?: string;
2804
- defaultView?: string;
2805
- onViewChange?: (value: string) => void;
2806
- /** Main action at the end of the bar; `null` hides it. */
2807
- primaryAction?: PageChromeAction | null;
2808
- 'aria-label'?: string;
2809
- className?: string;
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;
2810
2731
  }
2811
- /** List/table toolbar: search, filters, view toggle and the primary action, with one Tab stop. */
2812
- 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;
2813
- //#endregion
2814
- //#region src/page-chrome/PageToolbar/fixtures.d.ts
2815
- export declare const pageToolbarViews: PageToolbarView[];
2816
2732
  //#endregion
2817
- //#region src/page-chrome/PageToolbar/block.meta.d.ts
2818
- declare const meta$47: BlockMeta;
2819
- //#endregion
2820
- //#region src/page-chrome/StickyActionBar/StickyActionBar.d.ts
2821
- export interface StickyActionBarProps {
2822
- /** Whether the form has unsaved changes; Save and Discard are disabled while clean. */
2823
- dirty?: boolean;
2824
- /** Shows a spinner on Save and blocks both buttons. */
2825
- saving?: boolean;
2826
- onSave?: () => void;
2827
- onCancel?: () => void;
2828
- /** Text while dirty. */
2829
- dirtyMessage?: ReactNode;
2830
- /** Text while clean. */
2831
- cleanMessage?: ReactNode;
2832
- saveLabel?: string;
2833
- cancelLabel?: string;
2834
- /** Render nothing while clean (the bar slides in only when there is something to save). */
2835
- hideWhenClean?: boolean;
2836
- /** Accessible name of the region. */
2837
- 'aria-label'?: string;
2838
- 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;
2839
2743
  }
2840
- /** Bottom bar for long forms: unsaved-changes status plus Discard / Save, sticky to the viewport. */
2841
- 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;
2842
- //#endregion
2843
- //#region src/page-chrome/StickyActionBar/block.meta.d.ts
2844
- declare const meta$69: BlockMeta;
2845
- //#endregion
2846
- //#region src/page-chrome/BulkActionBar/BulkActionBar.d.ts
2847
- export interface BulkActionBarProps {
2848
- /** Number of selected rows; the bar renders nothing at 0. */
2849
- selectedCount?: number;
2850
- /** Total rows, shown as "3 of 24 selected". */
2851
- totalCount?: number;
2852
- /** Noun for the count, singular and plural. */
2853
- noun?: [singular: string, plural: string];
2854
- actions?: PageChromeAction[];
2855
- onClear?: () => void;
2856
- clearLabel?: string;
2857
- className?: string;
2744
+ /**
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.
2748
+ */
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;
2858
2762
  }
2859
- /** Contextual toolbar shown while rows are selected: count, bulk actions and clear selection. */
2860
- export declare function BulkActionBar({ selectedCount, totalCount, noun: nounProp, actions, onClear, clearLabel: clearLabelProp, className }: BulkActionBarProps): import("react").JSX.Element | null;
2861
- //#endregion
2862
- //#region src/page-chrome/BulkActionBar/block.meta.d.ts
2863
- declare const meta$6: BlockMeta;
2864
- //#endregion
2865
- //#region src/scheduling/shared/dates.d.ts
2866
- /** The clock options accepted by the scheduling blocks. */
2867
- type HourCycle = 'h12' | 'h23';
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;
2868
2769
  //#endregion
2869
- //#region src/scheduling/shared/events.d.ts
2870
- /** A scheduled item on a calendar. */
2871
- interface ScheduleEvent {
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;
2781
+ }
2782
+ interface DataTableView {
2872
2783
  id: string;
2873
- title: string;
2874
- start: Date;
2875
- end: Date;
2876
- /** Key into the `kinds` map (job, deploy, review, backup, maintenance…). */
2877
- kind?: string;
2878
- /** Region, room or target, shown after the time. */
2879
- location?: string;
2784
+ name: string;
2785
+ state: DataTableViewState;
2880
2786
  }
2881
- type EventTone = 'primary' | 'violet' | 'cyan' | 'amber' | 'neutral';
2882
- interface EventKind {
2883
- label: string;
2884
- icon: LucideIcon;
2885
- tone: EventTone;
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;
2886
2801
  }
2887
- /** Default kinds: brand green for jobs, categorical accents for the rest (never severity). */
2888
- export declare const defaultEventKinds: Record<string, EventKind>;
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;
2889
2804
  //#endregion
2890
- //#region src/scheduling/MonthCalendar/MonthCalendar.d.ts
2891
- export interface MonthCalendarProps {
2892
- events?: ScheduleEvent[];
2893
- /** Clock used for event times; defaults to the provider or runtime locale. */
2894
- hourCycle?: HourCycle;
2895
- /** First weekday; defaults to the provider or runtime locale. */
2896
- weekStartsOn?: WeekDay;
2897
- /** The app's "today" (the block never reads the clock). */
2898
- today?: Date;
2899
- /** Month shown first (uncontrolled). Defaults to the month of `today`. */
2900
- defaultMonth?: Date;
2901
- onMonthChange?: (month: Date) => void;
2902
- /** Initially selected day (uncontrolled). */
2903
- defaultSelected?: Date;
2904
- /** Called when a day is activated (click, Enter or Space). */
2905
- onSelectDate?: (date: Date, events: ScheduleEvent[]) => void;
2906
- /** Event kinds (label, icon, tone) by `event.kind`. */
2907
- kinds?: Record<string, EventKind>;
2908
- /** Event lines per day before "+N more". */
2909
- maxEventsPerDay?: number;
2910
- /** Caller actions in the header (e.g. a "Schedule" button). */
2911
- actions?: ReactNode;
2912
- 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';
2913
2813
  }
2914
- /**
2915
- * Month view of scheduled work: a locale-first grid with up to N events per day.
2916
- * Keyboard: arrows move by day/week, Home/End to the week edges, PageUp/PageDown by month,
2917
- * Enter/Space selects.
2918
- */
2919
- export declare function MonthCalendar({ events, hourCycle: hourCycleProp, weekStartsOn: weekStartsOnProp, today, defaultMonth, onMonthChange, defaultSelected, onSelectDate, kinds, maxEventsPerDay, actions, className }: MonthCalendarProps): import("react").JSX.Element;
2920
- //#endregion
2921
- //#region src/scheduling/MonthCalendar/block.meta.d.ts
2922
- declare const meta$44: BlockMeta;
2814
+ interface DataTableCsvExportOptions {
2815
+ fileName?: string;
2816
+ scopes?: Array<'rows' | 'page' | 'selected'>;
2817
+ }
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;
2864
+ /**
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.
2867
+ */
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;
2957
+ className?: string;
2958
+ }
2959
+ interface ClientPaginationProps {
2960
+ paginationMode?: 'client';
2961
+ rowCount?: never;
2962
+ page?: never;
2963
+ pageSize?: never;
2964
+ onPageChange?: never;
2965
+ onPageSizeChange?: never;
2966
+ }
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)));
2923
2993
  //#endregion
2924
- //#region src/scheduling/WeekCalendar/WeekCalendar.d.ts
2925
- export interface WeekCalendarProps {
2926
- events?: ScheduleEvent[];
2927
- /** First weekday; defaults to the provider or runtime locale. */
2928
- weekStartsOn?: WeekDay;
2929
- /** Clock used for events and hour labels; defaults to the provider or runtime locale. */
2930
- hourCycle?: HourCycle;
2931
- /** The app's "today" (the block never reads the clock). */
2932
- today?: Date;
2933
- /** Current time for the "now" line, shown when it falls in the visible week. Defaults to `today`. */
2934
- now?: Date;
2935
- /** A date inside the week shown first (uncontrolled). Defaults to `today`. */
2936
- defaultWeek?: Date;
2937
- /** Called with the first day of the newly shown week. */
2938
- onWeekChange?: (weekStart: Date) => void;
2939
- /** Makes events buttons. */
2940
- onEventClick?: (event: ScheduleEvent) => void;
2941
- kinds?: Record<string, EventKind>;
2942
- /** Hour the grid scrolls to on mount. */
2943
- scrollToHour?: number;
2944
- /** Pixels per hour. */
2945
- hourHeight?: number;
2946
- /** Max height of the scrolling time grid in px. */
2947
- height?: number;
2948
- actions?: ReactNode;
2994
+ //#region src/tables/DataTable/fixtures.d.ts
2995
+ interface DeploymentRow {
2996
+ id: string;
2997
+ name: string;
2998
+ region: string;
2999
+ status: 'running' | 'queued' | 'paused' | 'degraded' | 'failed';
3000
+ requests: number;
3001
+ cost: number;
3002
+ updatedAt: Date;
3003
+ }
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>[];
3010
+ //#endregion
3011
+ //#region src/tables/DataTable/DataTable.d.ts
3012
+ /**
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.
3017
+ */
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;
3019
+ //#endregion
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;
3029
+ }
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>;
3050
+ className?: string;
3051
+ }
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;
3059
+ //#endregion
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;
3069
+ }
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;
3131
+ }
3132
+ /**
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).
3136
+ */
3137
+ export declare function useTableData<T, F = unknown>(options: UseTableDataOptions<T, F>): UseTableDataResult<T, F>;
3138
+ //#endregion
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 {
3146
+ label: string;
3147
+ href?: string;
3148
+ onClick?: () => void;
3149
+ /** Trailing icon (lucide component). */
3150
+ icon?: IconComponent;
3151
+ }
3152
+ //#endregion
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';
3167
+ className?: string;
3168
+ }
3169
+ /** Neutral app-window placeholder for the screenshot slot (decorative). */
3170
+ export declare function HeroScreenshotPlaceholder({ className }: {
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;
3184
+ }
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';
3194
+ className?: string;
3195
+ }
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;
3198
+ //#endregion
3199
+ //#region src/marketing/FeatureGrid/block.meta.d.ts
3200
+ declare const meta$26: BlockMeta;
3201
+ //#endregion
3202
+ //#region src/marketing/FeatureGrid/fixtures.d.ts
3203
+ /** Sample product-agnostic features. */
3204
+ export declare const sampleFeatures: Feature[];
3205
+ //#endregion
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;
2949
3264
  className?: string;
2950
3265
  }
2951
- /** Week view: seven day columns over a scrolling 24-hour time grid, with a "now" line. */
2952
- 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;
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;
2953
3268
  //#endregion
2954
- //#region src/scheduling/WeekCalendar/block.meta.d.ts
2955
- declare const meta$77: BlockMeta;
3269
+ //#region src/marketing/PricingTable/block.meta.d.ts
3270
+ declare const meta$54: BlockMeta;
2956
3271
  //#endregion
2957
- //#region src/scheduling/AgendaList/AgendaList.d.ts
2958
- export interface AgendaListProps {
2959
- events?: ScheduleEvent[];
2960
- /** Clock used for event ranges; defaults to the provider or runtime locale. */
2961
- hourCycle?: HourCycle;
2962
- /** The app's "today": labels the Today/Tomorrow groups. */
2963
- today?: Date;
2964
- /** Only events on or after this day. Defaults to `today`; pass null for all. */
2965
- from?: Date | null;
2966
- /** Number of days shown from `from`. Default 7; null for no limit. */
2967
- days?: number | null;
2968
- /** Makes each row a button. */
2969
- onEventClick?: (event: ScheduleEvent) => void;
2970
- kinds?: Record<string, EventKind>;
2971
- title?: string;
2972
- /** Max height of the scrolling list in px. */
2973
- maxHeight?: number;
2974
- emptyTitle?: string;
2975
- emptyDescription?: string;
2976
- /** Heading level of the title, to fit the page outline (default h3); inner headings use the next level. */
2977
- titleAs?: 'h2' | 'h3' | 'h4';
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[];
3275
+ //#endregion
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';
2978
3293
  className?: string;
2979
3294
  }
2980
- /** Upcoming scheduled work grouped by day, each row with a kind tile, time range and location. */
2981
- 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;
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;
2982
3297
  //#endregion
2983
- //#region src/scheduling/AgendaList/block.meta.d.ts
2984
- declare const meta$2: BlockMeta;
3298
+ //#region src/marketing/Faq/block.meta.d.ts
3299
+ declare const meta$25: BlockMeta;
2985
3300
  //#endregion
2986
- //#region src/scheduling/TimeSlotPicker/TimeSlotPicker.d.ts
2987
- export interface TimeSlot {
2988
- /** Submitted value, e.g. "09:30". */
2989
- value: string;
2990
- /** Visible label. Defaults to `value`. */
2991
- label?: string;
2992
- /** Taken slots render struck through and disabled. Default true. */
2993
- available?: boolean;
3301
+ //#region src/marketing/Faq/fixtures.d.ts
3302
+ /** Sample product-agnostic questions. */
3303
+ export declare const sampleFaqs: FaqItem[];
3304
+ //#endregion
3305
+ //#region src/marketing/ComparisonTable/ComparisonTable.d.ts
3306
+ /** A plan or option: one column of the comparison. */
3307
+ export interface ComparisonPlan {
3308
+ id: string;
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;
2994
3316
  }
2995
- export interface TimeSlotPickerProps {
2996
- slots?: TimeSlot[];
2997
- /** Controlled value. */
2998
- value?: string | null;
2999
- /** Uncontrolled initial value. */
3000
- defaultValue?: string | null;
3001
- onValueChange?: (value: string) => void;
3002
- /** Group label (the fieldset legend). */
3003
- legend?: string;
3004
- /** Secondary line under the legend, e.g. the chosen date. */
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;
3321
+ };
3322
+ export interface ComparisonFeature {
3323
+ id: string;
3324
+ label: string;
3325
+ /** Muted text under the label. */
3005
3326
  description?: string;
3006
- /** Form field name. */
3007
- name?: string;
3008
- /** Slot columns from the `sm` breakpoint (two on small screens). */
3009
- columns?: 2 | 3 | 4 | 6;
3010
- /** Max height of the scrolling slot list in px. */
3011
- maxHeight?: number;
3327
+ /** Value per plan id. Missing / null values render like `false` (a dash, "Not included"). */
3328
+ values: Readonly<Record<string, ComparisonValue>>;
3329
+ }
3330
+ export interface ComparisonSection {
3331
+ id: string;
3332
+ title: string;
3333
+ features: ComparisonFeature[];
3334
+ }
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;
3012
3358
  className?: string;
3013
3359
  }
3014
3360
  /**
3015
- * Pick one time slot. Native radio semantics: Tab enters the group, arrow keys move and select,
3016
- * taken slots are disabled.
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.
3017
3364
  */
3018
- export declare function TimeSlotPicker({ slots, value, defaultValue, onValueChange, legend: legendProp, description, name, columns, maxHeight, className }: TimeSlotPickerProps): import("react").JSX.Element;
3019
- //#endregion
3020
- //#region src/scheduling/TimeSlotPicker/block.meta.d.ts
3021
- declare const meta$72: BlockMeta;
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;
3022
3366
  //#endregion
3023
- //#region src/scheduling/TimeSlotPicker/fixtures.d.ts
3024
- /** Half-hour slots from 09:00 to 21:00 with a few already taken. */
3025
- export declare const sampleTimeSlots: TimeSlot[];
3367
+ //#region src/marketing/ComparisonTable/block.meta.d.ts
3368
+ declare const meta$10: BlockMeta;
3026
3369
  //#endregion
3027
- //#region src/scheduling/shared/fixtures.d.ts
3028
- /** The sample calendar's "today" (Wed 15 Apr 2026, 10:20). Pass your own `today` in apps. */
3029
- declare const sampleToday: Date;
3030
- /** Sample scheduled work for April 2026 (jobs, deploys, reviews, backups, maintenance). */
3031
- declare const sampleEvents: ScheduleEvent[];
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[];
3032
3375
  //#endregion
3033
- //#region src/shell/AppSidebar/fixtures.d.ts
3034
- export declare const appSidebarNavGroups: NavGroup[];
3035
- export declare const appSidebarWorkspaces: Workspace[];
3036
- export interface AppSidebarUsage {
3376
+ //#region src/marketing/SiteFooter/SiteFooter.d.ts
3377
+ export interface SiteFooterLink {
3037
3378
  label: string;
3038
- value: number;
3039
- max: number;
3040
- /** Formatted value, e.g. "8.2k / 10k requests". */
3041
- valueLabel?: string;
3379
+ href: string;
3380
+ external?: boolean;
3042
3381
  }
3043
- export declare const appSidebarUsage: AppSidebarUsage;
3044
- export declare const appSidebarUser: UserMenuUser;
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;
3411
+ className?: string;
3412
+ }
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;
3045
3415
  //#endregion
3046
- //#region src/shell/AppSidebar/AppSidebar.d.ts
3047
- export interface AppSidebarHeaderProps {
3048
- /** Icon rail: shows only the brand mark. */
3049
- collapsed?: boolean;
3050
- /** Workspaces for the switcher; `null` shows the logo + wordmark instead. */
3051
- workspaces?: Workspace[] | null;
3052
- currentWorkspaceId?: string;
3053
- onWorkspaceChange?: (workspace: Workspace) => void;
3054
- onCreateWorkspace?: () => void;
3416
+ //#region src/marketing/SiteFooter/block.meta.d.ts
3417
+ declare const meta$65: BlockMeta;
3418
+ //#endregion
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[];
3423
+ //#endregion
3424
+ //#region src/marketing/LogoCloud/LogoCloud.d.ts
3425
+ export interface LogoCloudItem {
3426
+ id: string;
3427
+ name: string;
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. */
3055
3431
  className?: string;
3056
3432
  }
3057
- /** Sidebar top: workspace switcher (or the brand logo), the brand mark alone in the icon rail. */
3058
- export declare function AppSidebarHeader({ collapsed, workspaces, currentWorkspaceId, onWorkspaceChange, onCreateWorkspace, className }: AppSidebarHeaderProps): import("react").JSX.Element;
3059
- export interface AppSidebarNavProps {
3060
- groups?: NavGroup[];
3061
- currentHref?: string;
3062
- collapsed?: boolean;
3063
- /** Accessible name of the nav landmark. */
3064
- label?: string;
3065
- onNavigate?: (item: NavItem) => 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. */
3066
3447
  className?: string;
3067
3448
  }
3068
- /** Sidebar body: the NavList (icon rail with tooltips when collapsed). */
3069
- export declare function AppSidebarNav({ groups, currentHref, collapsed, label, onNavigate, className }: AppSidebarNavProps): import("react").JSX.Element;
3070
- export interface AppSidebarFooterProps {
3071
- collapsed?: boolean;
3072
- /** Plan usage meter; `null` hides it. */
3073
- usage?: AppSidebarUsage | null;
3074
- /** Help link; `null` hides it. */
3075
- helpHref?: string | null;
3076
- helpLabel?: string;
3077
- /** Signed-in user; `null` hides the user menu. */
3078
- user?: UserMenuUser | null;
3079
- userMenuItems?: UserMenuEntry[];
3080
- onSignOut?: () => void;
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;
3451
+ //#endregion
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[];
3510
+ /**
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.
3513
+ */
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;
3081
3520
  className?: string;
3082
3521
  }
3083
- /** Sidebar bottom: usage meter, help link and the user menu (avatar only in the icon rail). */
3084
- export declare function AppSidebarFooter({ collapsed, usage, helpHref, helpLabel, user, userMenuItems, onSignOut, className }: AppSidebarFooterProps): import("react").JSX.Element;
3085
- export interface AppSidebarProps extends AppSidebarHeaderProps, Omit<AppSidebarNavProps, 'className' | 'groups' | 'label'>, Omit<AppSidebarFooterProps, 'className'> {
3086
- navGroups?: NavGroup[];
3087
- navLabel?: string;
3088
- }
3089
- /**
3090
- * Complete application sidebar column (chrome surface): workspace switcher header, NavList body
3091
- * and a footer with usage, help and the user menu. Inside SidebarLayout, use the parts
3092
- * (AppSidebarHeader / AppSidebarNav / AppSidebarFooter) in its three slots.
3093
- */
3094
- 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;
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;
3095
3524
  //#endregion
3096
- //#region src/shell/AppSidebar/block.meta.d.ts
3097
- declare const meta$3: BlockMeta;
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[];
3098
3529
  //#endregion
3099
- //#region src/shell/EnvironmentBadge/EnvironmentBadge.d.ts
3100
- export type EnvironmentTone = 'primary' | 'warning' | 'info' | 'neutral' | 'destructive';
3101
- /** Default tone per environment name; anything else is neutral. */
3102
- export declare const environmentTones: Record<string, EnvironmentTone>;
3103
- export interface EnvironmentBadgeProps {
3104
- /** Environment name, e.g. `production`, `staging`, `preview`. */
3105
- environment?: string;
3106
- /** Region or cluster shown after the environment, e.g. `eu-west`; `null` hides it. */
3107
- region?: string | null;
3108
- /** Overrides the tone looked up from `environmentTones`. */
3109
- tone?: EnvironmentTone;
3110
- /** Prefix read by screen readers only. */
3111
- srLabel?: string;
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;
3112
3547
  className?: string;
3113
3548
  }
3114
- /** Environment + region chip for the topbar or a page header: "production · eu-west". */
3115
- export declare function EnvironmentBadge({ environment, region, tone, srLabel, className }: EnvironmentBadgeProps): import("react").JSX.Element;
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;
3116
3551
  //#endregion
3117
- //#region src/shell/AppTopbar/AppTopbar.d.ts
3118
- export interface AppTopbarProps {
3119
- /** Location trail; `null` hides it. */
3120
- breadcrumbs?: BreadcrumbItem[] | null;
3121
- /** Replaces the breadcrumb (custom title, tabs…). */
3122
- breadcrumb?: ReactNode;
3123
- /** Environment chip after the breadcrumb; `null` hides it. */
3124
- environment?: EnvironmentBadgeProps | null;
3125
- /** Search control; defaults to GlobalSearch (⌘K). `null` hides it. */
3126
- search?: ReactNode;
3127
- /** Notifications; `null` hides the bell. */
3128
- notifications?: NotificationItem[] | null;
3129
- onNotificationSelect?: (notification: NotificationItem) => void;
3130
- onMarkAllRead?: () => void;
3131
- /** Theme control: a one-button cycle, the segmented switcher, or none. */
3132
- theme?: 'cycle' | 'segmented' | null;
3133
- /** Signed-in user; `null` hides the user menu. */
3134
- user?: UserMenuUser | null;
3135
- userMenuItems?: UserMenuEntry[];
3136
- onSignOut?: () => void;
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;
3569
+ /**
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.
3572
+ */
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;
3137
3582
  className?: string;
3138
3583
  }
3139
- /**
3140
- * Topbar contents: breadcrumb (+ environment chip) on the left; ⌘K search, notifications, theme
3141
- * and user menu on the right. Renders no <header>: put it in SidebarLayout's `topbar` slot or a
3142
- * header of your own.
3143
- */
3144
- export declare function AppTopbar({ breadcrumbs, breadcrumb, environment, search, notifications, onNotificationSelect, onMarkAllRead, theme, user, userMenuItems, onSignOut, className }: AppTopbarProps): import("react").JSX.Element;
3145
- //#endregion
3146
- //#region src/shell/AppTopbar/fixtures.d.ts
3147
- export declare const appTopbarBreadcrumbs: BreadcrumbItem[];
3148
- export declare const appTopbarNotifications: NotificationItem[];
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;
3149
3586
  //#endregion
3150
- //#region src/shell/AppTopbar/block.meta.d.ts
3151
- declare const meta$4: BlockMeta;
3587
+ //#region src/page-chrome/PageToolbar/fixtures.d.ts
3588
+ export declare const pageToolbarViews: PageToolbarView[];
3152
3589
  //#endregion
3153
- //#region src/shell/EnvironmentBadge/block.meta.d.ts
3154
- declare const meta$22: BlockMeta;
3590
+ //#region src/page-chrome/PageToolbar/block.meta.d.ts
3591
+ declare const meta$48: BlockMeta;
3155
3592
  //#endregion
3156
- //#region src/shell/GlobalSearch/GlobalSearch.d.ts
3157
- export type GlobalSearchGroup = 'pages' | 'records' | 'actions' | 'recent';
3158
- export interface GlobalSearchProps {
3159
- pages?: CommandItem[];
3160
- records?: CommandItem[];
3161
- actions?: CommandItem[];
3162
- /** Shown first while the query is empty. */
3163
- recent?: CommandItem[];
3164
- /** Called with every chosen item and the group it came from (after the item's own onSelect). */
3165
- onSelect?: (item: CommandItem, group: GlobalSearchGroup) => void;
3166
- /** Group headings. */
3167
- labels?: Partial<Record<GlobalSearchGroup, string>>;
3168
- /** Registers ⌘K / Ctrl+K. */
3169
- shortcut?: boolean;
3170
- open?: boolean;
3171
- defaultOpen?: boolean;
3172
- onOpenChange?: (open: boolean) => void;
3173
- placeholder?: string;
3174
- /** Text of the trigger button. */
3175
- triggerLabel?: string;
3176
- /** Classes for the trigger (e.g. `hidden md:inline-flex`). */
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;
3177
3611
  className?: string;
3178
3612
  }
3179
- /** ⌘K search: a CommandPalette pre-wired with recent items and Pages / Records / Actions groups. */
3180
- export declare function GlobalSearch({ pages, records, actions, recent, onSelect, labels, shortcut, open, defaultOpen, onOpenChange, placeholder: placeholderProp, triggerLabel: triggerLabelProp, className }: GlobalSearchProps): import("react").JSX.Element;
3181
- //#endregion
3182
- //#region src/shell/GlobalSearch/fixtures.d.ts
3183
- export declare const globalSearchPages: CommandItem[];
3184
- export declare const globalSearchRecords: CommandItem[];
3185
- export declare const globalSearchActions: CommandItem[];
3186
- export declare const globalSearchRecent: CommandItem[];
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;
3187
3615
  //#endregion
3188
- //#region src/shell/GlobalSearch/block.meta.d.ts
3189
- declare const meta$32: BlockMeta;
3616
+ //#region src/page-chrome/StickyActionBar/block.meta.d.ts
3617
+ declare const meta$71: BlockMeta;
3190
3618
  //#endregion
3191
- //#region src/tables/DataTable/data-table-utils.d.ts
3192
- export type SortDirectionValue = 'ascending' | 'descending';
3193
- /** Include lists selected ids; exclude selects every match except the listed ids. */
3194
- export type DataTableSelectionModel = {
3195
- type: 'include';
3196
- ids: string[];
3197
- } | {
3198
- type: 'exclude';
3199
- ids: string[];
3200
- };
3201
- export type CellValue = string | number | boolean | Date | null | undefined;
3202
- export type DataTableColumnVariant = 'default' | 'mono' | 'muted' | 'numeric';
3203
- /** Body-cell classes of each column variant. */
3204
- export declare const COLUMN_VARIANT_CLASSES: Record<DataTableColumnVariant, string>;
3205
- /** Effective alignment of a column (numeric columns default to right). */
3206
- export declare function columnAlign<T>(column: DataTableColumn<T>): DataTableColumn<T>['align'];
3207
- /** One typed column of a DataTable. */
3208
- export interface DataTableColumn<T> {
3209
- /** Stable key (sorting, visibility). */
3210
- id: string;
3211
- /** Header text; also the column's name in the visibility menu. */
3212
- header: string;
3213
- /** Raw value: used to sort, and rendered when `cell` is absent. */
3214
- accessor?: (row: T) => CellValue;
3215
- /** Custom cell rendering. */
3216
- cell?: (row: T) => ReactNode;
3217
- sortable?: boolean;
3218
- align?: 'left' | 'right' | 'center';
3219
- /** Can be hidden from the column menu (default true). */
3220
- hideable?: boolean;
3221
- /** Hidden until turned on in the column menu. */
3222
- defaultHidden?: boolean;
3223
- /**
3224
- * Presentational preset for the body cells: `mono` (monospace ids, regions), `muted`
3225
- * (secondary text), `numeric` (monospace tabular figures, right-aligned unless `align` is set).
3226
- */
3227
- variant?: DataTableColumnVariant;
3228
- /** Classes for the body cells (merged after the variant's). */
3229
- className?: string;
3230
- /** Classes for the header cell (e.g. a width). */
3231
- headClassName?: string;
3232
- /** Initial width in px (resizable or pinned tables; default 160). */
3233
- width?: number;
3234
- /** Smallest width a resize can reach (default 60). */
3235
- minWidth?: number;
3236
- /** Largest width a resize can reach (default 640). */
3237
- maxWidth?: number;
3238
- /** Shows a resize handle when the table is `resizable` (default true). */
3239
- resizable?: boolean;
3240
- /** Can be pinned from the column menu (default true). */
3241
- pinnable?: boolean;
3242
- /** Inline editing: Enter or F2 on the cell edits it (needs `onCellEdit` on the table). */
3243
- editable?: boolean | ((row: T) => boolean);
3244
- /** Editor of an editable cell (default a text input). */
3245
- editor?: DataTableCellEditor;
3246
- /** Value the editor starts from (default the accessor's value). */
3247
- editValue?: (row: T) => string | number | null | undefined;
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;
3248
3631
  }
3249
- /** Editor of an editable column. */
3250
- export type DataTableCellEditor = {
3251
- type: 'text';
3252
- placeholder?: string;
3253
- } | {
3254
- type: 'number';
3255
- min?: number;
3256
- max?: number;
3257
- step?: number;
3258
- } | {
3259
- type: 'select';
3260
- options: ReadonlyArray<{
3261
- value: string;
3262
- label: string;
3263
- }>;
3264
- };
3265
- export interface SortState {
3266
- columnId: string;
3267
- direction: SortDirectionValue;
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;
3268
3653
  }
3269
- /** Compares two cell values: nulls last, numbers and dates numerically, strings with localeCompare (numeric). */
3270
- export declare function compareValues(a: CellValue, b: CellValue): number;
3271
- /** Client-side sort (stable). Returns the input order when there is no sort or the column has no accessor. */
3272
- export declare function sortRows<T>(rows: readonly T[], columns: ReadonlyArray<DataTableColumn<T>>, sort: SortState | null): T[];
3273
- /** Number of pages for a row count (at least 1). */
3274
- export declare function pageCountOf(total: number, pageSize: number): number;
3275
- /** Client-side pagination: the rows of a 1-based page (clamped to the valid range). */
3276
- export declare function paginate<T>(rows: readonly T[], page: number, pageSize: number): T[];
3277
- /** Header checkbox state for the rows on screen. */
3278
- export declare function selectionState(visibleIds: readonly string[], selected: ReadonlySet<string>): {
3279
- checked: boolean;
3280
- indeterminate: boolean;
3281
- };
3282
- /** Selects all of `ids` when not all are selected; otherwise clears them. Other selections are kept. */
3283
- export declare function toggleAll(ids: readonly string[], selected: ReadonlySet<string>): Set<string>;
3284
- export declare function toggleOne(id: string, selected: ReadonlySet<string>): Set<string>;
3285
- /** Optional locale and boolean text for default cells. */
3286
- export interface DataTableCellFormatOptions {
3287
- locale?: string;
3288
- booleanLabels?: [trueLabel: string, falseLabel: string];
3654
+ type EventTone = 'primary' | 'violet' | 'cyan' | 'amber' | 'neutral';
3655
+ interface EventKind {
3656
+ label: string;
3657
+ icon: LucideIcon;
3658
+ tone: EventTone;
3289
3659
  }
3290
- /** Default cell text for a raw value. Omitting options preserves the legacy output. */
3291
- export declare function formatCell(value: CellValue, options?: DataTableCellFormatOptions): ReactNode;
3292
- /** Groups rows by a field key or by a function returning the group key. */
3293
- export type DataTableGroupBy<T> = Extract<keyof T, string> | ((row: T) => string | number | null | undefined);
3294
- /** One group of rows, in display order. */
3295
- export interface DataTableGroup<T> {
3296
- /** Group key (`''` for rows without a value). */
3297
- key: string;
3298
- rows: T[];
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;
3299
3688
  }
3300
- /** Group key of a row (`''` when the value is null or undefined). */
3301
- export declare function groupKeyOf<T>(row: T, groupBy: DataTableGroupBy<T>): string;
3302
3689
  /**
3303
- * Splits rows into groups, keeping the row order inside each group. Groups follow `order` (the
3304
- * keys' first appearance in it, e.g. the unsorted input) and then any key not seen there.
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.
3305
3693
  */
3306
- export declare function groupRows<T>(rows: readonly T[], groupBy: DataTableGroupBy<T>, order?: readonly T[]): DataTableGroup<T>[];
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;
3307
3695
  //#endregion
3308
- //#region src/tables/DataTable/column-sizing.d.ts
3309
- /** Column widths in px by column id. */
3310
- type ColumnWidths = Readonly<Record<string, number>>;
3311
- /** Columns pinned to the start (left in LTR) and end edges, in display order. */
3312
- interface PinnedColumns {
3313
- left?: readonly string[];
3314
- right?: readonly string[];
3315
- }
3316
- type PinSide = 'left' | 'right';
3317
- export declare const DEFAULT_COLUMN_WIDTH = 160;
3318
- export declare const MIN_COLUMN_WIDTH = 60;
3319
- export declare const MAX_COLUMN_WIDTH = 640;
3320
- /** Clamps a width to the column's limits (rounded to whole px). */
3321
- export declare function clampColumnWidth<T>(column: DataTableColumn<T>, width: number): number;
3322
- /** Effective width of a column: the widths map, then `column.width`, then the default. */
3323
- export declare function columnWidthOf<T>(column: DataTableColumn<T>, widths: ColumnWidths): number;
3324
- /** Pins a column to a side (appended to that side) or unpins it (`null`). */
3325
- export declare function setColumnPin(pinned: PinnedColumns, id: string, side: PinSide | null): PinnedColumns;
3326
- /** Display order: start-pinned columns (pin order), unpinned columns (column order), end-pinned columns. */
3327
- export declare function orderColumns<T>(columns: ReadonlyArray<DataTableColumn<T>>, pinned: PinnedColumns): Array<DataTableColumn<T>>;
3696
+ //#region src/scheduling/MonthCalendar/block.meta.d.ts
3697
+ declare const meta$45: BlockMeta;
3328
3698
  //#endregion
3329
- //#region src/tables/PaginationFooter/PaginationFooter.d.ts
3330
- export interface PaginationFooterLabels {
3331
- rowsPerPage: string;
3332
- rowsPerPageLabel: string;
3333
- rangeSummary: (from: number, to: number, total: number) => string;
3334
- paginationNav: (noun: string) => string;
3335
- previous: string;
3336
- next: string;
3337
- page: (page: number) => string;
3338
- }
3339
- export interface PaginationFooterProps {
3340
- /** Per-key overrides; omitted keys retain the existing provider translations and defaults. */
3341
- labels?: Partial<PaginationFooterLabels>;
3342
- /** Total number of rows. */
3343
- total?: number;
3344
- /** Current page, 1-based (controlled). */
3345
- page?: number;
3346
- defaultPage?: number;
3347
- onPageChange?: (page: number) => void;
3348
- /** Rows per page (controlled). */
3349
- pageSize?: number;
3350
- defaultPageSize?: number;
3351
- onPageSizeChange?: (pageSize: number) => void;
3352
- pageSizeOptions?: readonly number[];
3353
- /** What the rows are, for the accessible names ("Deployments"). */
3354
- noun?: string;
3355
- locale?: string;
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;
3356
3726
  className?: string;
3357
3727
  }
3358
- /** Table footer: rows-per-page Select, a "1–10 of 97" summary and numbered Pagination. Stacks on small screens. */
3359
- 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;
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;
3360
3730
  //#endregion
3361
- //#region src/tables/DataTable/labels.d.ts
3362
- /** Per-instance table chrome, including the composed PaginationFooter. Caller data stays caller-owned. */
3363
- interface DataTableLabels extends PaginationFooterLabels {
3364
- booleanTrue: string;
3365
- booleanFalse: string;
3366
- /** Non-virtual table overflow region; virtualized regions keep the caller caption. */
3367
- scrollRegion: string;
3368
- selectionCount: (count: number) => string;
3369
- pageSelected: (count: number) => string;
3370
- selectAllMatching: (count: number) => string;
3371
- allMatchingSelected: (count: number) => string;
3372
- clearSelection: string;
3373
- columns: string;
3374
- visibleColumns: string;
3375
- pinColumns: string;
3376
- pinnedLeft: string;
3377
- pinnedRight: string;
3378
- pinLeft: string;
3379
- pinRight: string;
3380
- unpinned: string;
3381
- density: string;
3382
- comfortable: string;
3383
- compact: string;
3384
- resizeColumn: (label: string) => string;
3385
- columnWidth: (width: number) => string;
3386
- defaultView: string;
3387
- defaultViewOption: string;
3388
- modified: string;
3389
- views: string;
3390
- saveChanges: string;
3391
- saveAs: string;
3392
- renameView: string;
3393
- deleteView: string;
3394
- resetChanges: string;
3395
- saveViewTitle: string;
3396
- renameViewTitle: string;
3397
- viewName: string;
3398
- cancel: string;
3399
- saveView: string;
3400
- rename: string;
3401
- closeDialog: string;
3402
- selection: string;
3403
- selectAll: string;
3404
- selectRow: (label: string) => string;
3405
- selectGroup: (group: string) => string;
3406
- groupRows: (count: number) => string;
3407
- noGroup: string;
3408
- actions: string;
3409
- rowActions: (label: string) => string;
3410
- emptyTitle: string;
3411
- emptyDescription: string;
3412
- loading: (caption: string) => string;
3413
- editHint: string;
3414
- editLabel: (column: string, row: string) => string;
3415
- editError: string;
3416
- enterNumber: string;
3417
- minimumValue: (min: number) => string;
3418
- maximumValue: (max: number) => string;
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;
3419
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;
3420
3761
  //#endregion
3421
- //#region src/tables/DataTable/editable-cell.d.ts
3422
- /** One committed cell edit, as `onCellEdit` receives it. */
3423
- interface DataTableCellEdit<T> {
3424
- row: T;
3425
- rowId: string;
3426
- columnId: string;
3427
- /** Parsed value: a string (text, select) or a number / null (number editor). */
3428
- value: string | number | null;
3429
- /** Value the editor started from. */
3430
- previous: string | number | null;
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;
3431
3773
  }
3432
- /**
3433
- * Result of `onCellEdit`: nothing or `true` accepts the edit (the parent updates `rows`); a string
3434
- * rejects it and is shown inline as the error; `false` rejects with a generic message. A thrown
3435
- * error (or a rejected promise) rejects with its message.
3436
- */
3437
- type DataTableCellEditResult = void | boolean | string;
3438
- type DataTableCellEditHandler<T> = (edit: DataTableCellEdit<T>) => DataTableCellEditResult | Promise<DataTableCellEditResult>;
3439
- interface EditableCellProps<T> {
3440
- labels?: Partial<DataTableLabels>;
3441
- row: T;
3442
- rowId: string;
3443
- rowLabel: string;
3444
- column: DataTableColumn<T>;
3445
- onCellEdit: DataTableCellEditHandler<T>;
3446
- /** Id of the shared "Press Enter or F2 to edit" hint. */
3447
- hintId: string;
3448
- /** The cell's display content. */
3449
- children: ReactNode;
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;
3450
3792
  }
3451
3793
  /**
3452
- * An editable body cell's content. At rest it is a button showing the value (Enter, F2 or a click
3453
- * edits); while editing, an input or a select: Enter or Tab commits, Escape cancels. `onCellEdit`
3454
- * can reject the value with a message, shown inline under the editor.
3794
+ * Pick one time slot. Native radio semantics: Tab enters the group, arrow keys move and select,
3795
+ * taken slots are disabled.
3455
3796
  */
3456
- export declare function EditableCell<T>({ row, rowId, rowLabel, column, onCellEdit, hintId, children, labels }: EditableCellProps<T>): import("react").JSX.Element;
3797
+ export declare function TimeSlotPicker({ slots, value, defaultValue, onValueChange, legend: legendProp, description, name, columns, maxHeight, className }: TimeSlotPickerProps): import("react").JSX.Element;
3457
3798
  //#endregion
3458
- //#region src/tables/DataTable/views.d.ts
3459
- /** What a saved view captures. Every field is optional: a missing field keeps the table's default. */
3460
- interface DataTableViewState {
3461
- /** Opaque filter state of the page's toolbar (see the table's `filters` / `onFiltersChange`). */
3462
- filters?: unknown;
3463
- sort?: SortState | null;
3464
- hiddenColumns?: readonly string[];
3465
- columnWidths?: ColumnWidths;
3466
- pinnedColumns?: PinnedColumns;
3467
- /** A field key, or `null` for no grouping (function `groupBy`s cannot be saved). */
3468
- groupBy?: string | null;
3469
- }
3470
- interface DataTableView {
3471
- id: string;
3472
- name: string;
3473
- state: DataTableViewState;
3474
- }
3475
- /** Whether two view states are equivalent (key order and empty values ignored). */
3476
- export declare function sameViewState(a: DataTableViewState, b: DataTableViewState): boolean;
3477
- interface ViewSwitcherProps {
3478
- labels?: Partial<DataTableLabels>;
3479
- views: readonly DataTableView[];
3480
- activeId: string | null;
3481
- /** The table differs from the active view (or from the defaults when none is active). */
3482
- dirty: boolean;
3483
- onSelect: (id: string | null) => void;
3484
- onSaveAs: (name: string) => void;
3485
- onSave: () => void;
3486
- onRename: (id: string, name: string) => void;
3487
- onDelete: (id: string) => void;
3488
- onReset: () => void;
3489
- }
3490
- /** "Views" menu: switch between saved views, save the current table as a view, rename, delete, reset. */
3491
- declare function ViewSwitcher({ labels, views, activeId, dirty, onSelect, onSaveAs, onSave, onRename, onDelete, onReset }: ViewSwitcherProps): import("react").JSX.Element;
3799
+ //#region src/scheduling/TimeSlotPicker/block.meta.d.ts
3800
+ declare const meta$74: BlockMeta;
3492
3801
  //#endregion
3493
- //#region src/tables/DataTable/data-table-props.d.ts
3494
- interface DataTableCommonProps<T> {
3495
- /** Per-key overrides; omitted keys keep existing defaults and provider translations. */
3496
- labels?: Partial<DataTableLabels>;
3497
- rows?: readonly T[];
3498
- columns?: ReadonlyArray<DataTableColumn<T>>;
3499
- /** Stable row id (defaults to `row.id`). */
3500
- getRowId?: (row: T) => string;
3501
- /** Row name for selection and menu labels (defaults to the first column's value). */
3502
- getRowLabel?: (row: T) => string;
3503
- /** Table name (screen-reader caption unless `showCaption`). */
3504
- caption?: string;
3505
- showCaption?: boolean;
3506
- /** Row selection with a select-all header checkbox (current page). */
3507
- selectable?: boolean;
3508
- /** Native radio name in single mode. Supplied names must be unique per page. */
3509
- selectionName?: string;
3510
- selectedId?: string | null;
3511
- defaultSelectedId?: string | null;
3512
- onSelectedIdChange?: (id: string) => void;
3513
- isRowDisabled?: (row: T) => boolean;
3514
- selectedIds?: readonly string[];
3515
- defaultSelectedIds?: readonly string[];
3516
- onSelectionChange?: (ids: string[]) => void;
3517
- /** Keep ids absent from rows. Defaults to true for server pagination, false for client pagination. */
3518
- preserveSelection?: boolean;
3519
- /** Offer to extend a selected page to all matching rows (default false). */
3520
- selectAllMatching?: boolean;
3521
- /** Hide the page select-all checkbox, retaining row controls and the column heading. */
3522
- hideSelectAll?: boolean;
3523
- /** Controlled model; takes precedence over selectedIds. */
3524
- selectionModel?: DataTableSelectionModel;
3525
- /** Required to offer select-all-matching with server pagination. */
3526
- onSelectionModelChange?: (model: DataTableSelectionModel) => void;
3527
- /** Rendered in the toolbar while rows are selected. */
3528
- bulkActions?: (selectedIds: string[], selection: DataTableSelectionModel) => ReactNode;
3529
- /**
3530
- * Shows the "N selected" text in the toolbar while rows are selected (default true). Turn it
3531
- * off when the page renders its own count, e.g. a BulkActionBar.
3532
- */
3533
- selectionSummary?: boolean;
3534
- /** Row-actions menu items. */
3535
- rowActions?: (row: T) => Array<MoreMenuAction | 'separator'>;
3536
- sort?: SortState | null;
3537
- defaultSort?: SortState | null;
3538
- onSortChange?: (sort: SortState) => void;
3539
- /** Rows arrive sorted (server side): headers still toggle, rows are not re-sorted. */
3540
- manualSorting?: boolean;
3541
- defaultPageSize?: number;
3542
- pageSizeOptions?: readonly number[];
3543
- /** Controlled row density. */
3544
- density?: TableDensity;
3545
- /** Initial density; omitted, the table follows the surrounding DensityProvider (comfortable outside one). */
3546
- defaultDensity?: TableDensity;
3547
- onDensityChange?: (density: TableDensity) => void;
3548
- showDensityToggle?: boolean;
3549
- showColumnMenu?: boolean;
3550
- loading?: boolean;
3551
- loadingRows?: number;
3552
- emptyState?: ReactNode;
3553
- /**
3554
- * Groups rows under header rows (a field key or a function returning the group key). Groups keep
3555
- * the order in which their keys first appear in `rows`; sorting applies inside each group, and
3556
- * pagination pages through the grouped rows (each header shows the group's full count).
3557
- */
3558
- groupBy?: DataTableGroupBy<T>;
3559
- /** Header text of a group (default: the key, or "No group" for rows without a value). */
3560
- groupLabel?: (key: string, rows: readonly T[]) => ReactNode;
3561
- /** Group headers render a keyboard-accessible collapse button (default true). */
3562
- collapsibleGroups?: boolean;
3563
- /** Controlled collapsed group keys. */
3564
- collapsedGroups?: readonly string[];
3565
- /** Group keys collapsed initially. */
3566
- defaultCollapsedGroups?: readonly string[];
3567
- onCollapsedGroupsChange?: (keys: string[]) => void;
3568
- /** Called when a saved view switches grouping (a field key, or `null` for none). */
3569
- onGroupByChange?: (groupBy: string | null) => void;
3570
- /** Controlled hidden column ids (default: columns with `defaultHidden`). */
3571
- hiddenColumns?: readonly string[];
3572
- onHiddenColumnsChange?: (ids: string[]) => void;
3573
- /** Resize handles on the column headers (pointer drag, or arrow keys on the focused handle). */
3574
- resizable?: boolean;
3575
- /** Controlled column widths in px by column id. */
3576
- columnWidths?: ColumnWidths;
3577
- defaultColumnWidths?: ColumnWidths;
3578
- onColumnWidthsChange?: (widths: Record<string, number>) => void;
3579
- /** Controlled pinned columns (sticky at the start or end edge while scrolling sideways). */
3580
- pinnedColumns?: PinnedColumns;
3581
- defaultPinnedColumns?: PinnedColumns;
3582
- onPinnedColumnsChange?: (pinned: PinnedColumns) => void;
3583
- /** Pin / unpin from the column menu (default true when pinning is in use: a pinned prop or callback). */
3584
- showPinMenu?: boolean;
3585
- /**
3586
- * Renders only the rows in view (plus overscan) inside a scrolling body with a sticky header.
3587
- * `'auto'` (default) turns it on above `virtualizeThreshold` rendered rows (with pagination,
3588
- * the rows of the current page). The table exposes `aria-rowcount` and each row its
3589
- * `aria-rowindex`; selection (select-all covers every row) and grouping keep working.
3590
- * Limits: rows get a fixed height (`rowHeight`), so multi-line cells are clipped; a row that
3591
- * scrolls out of view unmounts, so focus inside it (or an open inline editor) is lost; a group's
3592
- * header row renders only while it is in view.
3593
- */
3594
- virtualize?: boolean | 'auto';
3595
- virtualizeThreshold?: number;
3596
- /** Row height in px for virtualization (default by density: 44 comfortable, 36 compact). */
3597
- rowHeight?: number;
3598
- /** Classes of the virtualized scroll container: its max height (default `max-h-[32rem]`). */
3599
- virtualContainerClassName?: string;
3600
- /**
3601
- * Inline editing of `editable` columns. Return nothing to accept (and update `rows`), or a
3602
- * message (or throw) to reject: the message is shown inline under the editor.
3603
- */
3604
- onCellEdit?: DataTableCellEditHandler<T>;
3605
- /** Saved views (controlled). Each captures filters, sort, visible columns, widths, pinning and grouping. */
3606
- views?: readonly DataTableView[];
3607
- defaultViews?: readonly DataTableView[];
3608
- onViewsChange?: (views: DataTableView[]) => void;
3609
- activeViewId?: string | null;
3610
- defaultActiveViewId?: string | null;
3611
- onActiveViewChange?: (id: string | null) => void;
3612
- /** Shows the view switcher (default: when views are in use). */
3613
- showViewSwitcher?: boolean;
3614
- /** Opaque filter state of the page's toolbar, saved with views. */
3615
- filters?: unknown;
3616
- /** Called when a view (or a reset) restores filters. */
3617
- onFiltersChange?: (filters: unknown) => void;
3618
- /** Left side of the toolbar (title, search, FilterBar…). */
3619
- toolbar?: ReactNode;
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;
3620
3854
  className?: string;
3621
3855
  }
3622
- interface ClientPaginationProps {
3623
- paginationMode?: 'client';
3624
- rowCount?: never;
3625
- page?: never;
3626
- pageSize?: never;
3627
- onPageChange?: never;
3628
- 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;
3629
3866
  }
3630
- interface ServerPaginationProps {
3631
- /** Rows arrive as one server page: no client sorting or slicing, and no sortable headers. */
3632
- paginationMode: 'server';
3633
- /** Total number of rows across all pages; required even for an empty result. */
3634
- rowCount: number;
3635
- /** Current page, 1-based. Out-of-range pages are clamped for display without callbacks. */
3636
- page: number;
3637
- pageSize: number;
3638
- onPageChange?: (page: number) => void;
3639
- /** The footer may also request a page change to keep the first visible row on screen. */
3640
- 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;
3641
3883
  }
3642
- type DataTableProps<T> = DataTableCommonProps<T> & (({
3643
- selectionMode: 'single';
3644
- paginated?: boolean;
3645
- /** Consumer-supplied accessible group label; the kit adds no default. */
3646
- legend?: ReactNode;
3647
- 'aria-label'?: string;
3648
- 'aria-labelledby'?: string;
3649
- } & (ClientPaginationProps | ServerPaginationProps)) | ({
3650
- selectionMode?: 'none' | 'multiple';
3651
- paginated?: boolean;
3652
- legend?: never;
3653
- 'aria-label'?: never;
3654
- 'aria-labelledby'?: never;
3655
- } & (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;
3656
3896
  //#endregion
3657
- //#region src/tables/DataTable/fixtures.d.ts
3658
- interface DeploymentRow {
3659
- id: string;
3660
- name: string;
3661
- region: string;
3662
- status: 'running' | 'queued' | 'paused' | 'degraded' | 'failed';
3663
- requests: number;
3664
- cost: number;
3665
- 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;
3666
3914
  }
3667
- /** Deterministic deployments (the first 24 are DEPLOYMENT_ROWS); large counts exercise virtualization. */
3668
- export declare function generateDeployments(count: number): DeploymentRow[];
3669
- /** 24 deployments: enough for two pages at the default page size. */
3670
- export declare const DEPLOYMENT_ROWS: DeploymentRow[];
3671
- /** Columns for DEPLOYMENT_ROWS. */
3672
- 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;
3673
3917
  //#endregion
3674
- //#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
+ }
3675
3940
  /**
3676
- * Generic data table on the kit Table: typed columns, sortable headers (aria-sort), row selection
3677
- * with select-all / indeterminate, column visibility menu, density toggle, row actions, loading
3678
- * and empty states, client-side sort + pagination, optional collapsible row groups (`groupBy`),
3679
- * 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.
3680
3944
  */
3681
- 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, preserveSelection, selectAllMatching, hideSelectAll, selectionModel, onSelectionModelChange, 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;
3682
3991
  //#endregion
3683
3992
  //#region src/tables/DataTable/column-menu.d.ts
3684
3993
  interface ColumnVisibilityMenuProps<T> {
@@ -3780,7 +4089,7 @@ export interface FilterBarProps {
3780
4089
  className?: string;
3781
4090
  }
3782
4091
  /**
3783
- * 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),
3784
4093
  * removable filter chips (Token) and Clear all.
3785
4094
  */
3786
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;
@@ -3803,47 +4112,7 @@ export declare function CursorPagerFooter(props?: CursorPagerFooterProps): impor
3803
4112
  declare const meta$15: BlockMeta;
3804
4113
  //#endregion
3805
4114
  //#region src/tables/PaginationFooter/block.meta.d.ts
3806
- declare const meta$48: BlockMeta;
3807
- //#endregion
3808
- //#region src/tables/LoadMoreFooter/LoadMoreFooter.d.ts
3809
- export interface LoadMoreFooterLabels {
3810
- loadMore: string;
3811
- loading: string;
3812
- retry: string;
3813
- group: string;
3814
- moreAvailable: string;
3815
- summary: (count: number) => string;
3816
- loadedAnnouncement: (count: number) => string;
3817
- }
3818
- /**
3819
- * Each attempt must settle in one update: loading=false together with its result
3820
- * (error, or an empty error on success). Split settles are unsupported.
3821
- */
3822
- export interface LoadMoreFooterProps {
3823
- /** Undefined selects flag mode; null or an empty string exhausts cursor mode. */
3824
- nextCursor?: string | null;
3825
- hasMore?: boolean;
3826
- loading?: boolean;
3827
- error?: string;
3828
- onLoadMore?: (cursor?: string) => void;
3829
- onRetry?: (cursor?: string) => void;
3830
- loadedCount?: number;
3831
- /** Increasing sequence for successful appends only; leave unchanged on replacement or failure. */
3832
- lastAppend?: {
3833
- seq: number;
3834
- count: number;
3835
- };
3836
- exhaustedFocusTarget?: 'summary' | 'root';
3837
- labels?: Partial<LoadMoreFooterLabels>;
3838
- className?: string;
3839
- }
3840
- /**
3841
- * Load more for appended lists without a total or page count. The consumer owns rows and requests.
3842
- * With no props, renders a static catalogue preview using fixture data. Supplying any prop selects
3843
- * the consumer contract: undefined nextCursor means flag mode and requires hasMore=true.
3844
- * loadedCount defaults to the preview fixture; consumers should pass their actual loaded count.
3845
- */
3846
- export declare function LoadMoreFooter(props?: LoadMoreFooterProps): import("react").JSX.Element;
4115
+ declare const meta$49: BlockMeta;
3847
4116
  //#endregion
3848
4117
  //#region src/tables/LoadMoreFooter/block.meta.d.ts
3849
4118
  declare const meta$39: BlockMeta;
@@ -3872,7 +4141,7 @@ export interface TruncatedCollectionFooterProps {
3872
4141
  export declare function TruncatedCollectionFooter({ visibleCount, hasMore, noun: nounProp, locale: localeProp, summaryLabel, formatCount, truncationNote, noteId, className }: TruncatedCollectionFooterProps): import("react").JSX.Element;
3873
4142
  //#endregion
3874
4143
  //#region src/tables/TruncatedCollectionFooter/block.meta.d.ts
3875
- declare const meta$75: BlockMeta;
4144
+ declare const meta$77: BlockMeta;
3876
4145
  //#endregion
3877
4146
  //#region src/tables/InlineEditRow/fixtures.d.ts
3878
4147
  interface EditableMember {
@@ -3960,7 +4229,7 @@ export interface SubordinateListProps<T> {
3960
4229
  export declare function SubordinateList<T>({ title, headingLevel, count, columns, rows, getRowId, pagination, loading, error, onRetry, emptyState }: SubordinateListProps<T>): import("react").JSX.Element;
3961
4230
  //#endregion
3962
4231
  //#region src/tables/SubordinateList/block.meta.d.ts
3963
- declare const meta$70: BlockMeta;
4232
+ declare const meta$72: BlockMeta;
3964
4233
  //#endregion
3965
4234
  //#region src/team/MembersTable/fixtures.d.ts
3966
4235
  interface Member {
@@ -3991,7 +4260,7 @@ export interface MembersTableProps {
3991
4260
  export declare function MembersTable({ members, roles, currentUserId, onRoleChange, onRemove, onEmail, caption, className }: MembersTableProps): import("react").JSX.Element;
3992
4261
  //#endregion
3993
4262
  //#region src/team/MembersTable/block.meta.d.ts
3994
- declare const meta$41: BlockMeta;
4263
+ declare const meta$42: BlockMeta;
3995
4264
  //#endregion
3996
4265
  //#region src/team/NotificationMatrix/fixtures.d.ts
3997
4266
  interface NotificationChannel {
@@ -4028,7 +4297,7 @@ export interface NotificationMatrixProps {
4028
4297
  export declare function NotificationMatrix({ channels, events, value: valueProp, defaultValue, onValueChange, caption, className }: NotificationMatrixProps): import("react").JSX.Element;
4029
4298
  //#endregion
4030
4299
  //#region src/team/NotificationMatrix/block.meta.d.ts
4031
- declare const meta$45: BlockMeta;
4300
+ declare const meta$46: BlockMeta;
4032
4301
  //#endregion
4033
4302
  //#region src/team/PendingInvitations/fixtures.d.ts
4034
4303
  interface Invitation {
@@ -4057,7 +4326,7 @@ export interface PendingInvitationsProps {
4057
4326
  export declare function PendingInvitations({ invitations, onResend, onRevoke, title, headingLevel: Heading, className }: PendingInvitationsProps): import("react").JSX.Element;
4058
4327
  //#endregion
4059
4328
  //#region src/team/PendingInvitations/block.meta.d.ts
4060
- declare const meta$50: BlockMeta;
4329
+ declare const meta$51: BlockMeta;
4061
4330
  //#endregion
4062
4331
  //#region src/team/ProfileHeader/fixtures.d.ts
4063
4332
  interface ProfileMetaItem {
@@ -4091,7 +4360,7 @@ export interface ProfileHeaderProps {
4091
4360
  export declare function ProfileHeader({ profile, onAvatarChange, onEdit, actions, headingLevel: Heading, className }: ProfileHeaderProps): import("react").JSX.Element;
4092
4361
  //#endregion
4093
4362
  //#region src/team/ProfileHeader/block.meta.d.ts
4094
- declare const meta$54: BlockMeta;
4363
+ declare const meta$55: BlockMeta;
4095
4364
  //#endregion
4096
4365
  //#region src/team/SessionsDevices/fixtures.d.ts
4097
4366
  type DeviceKind = 'desktop' | 'mobile' | 'tablet';
@@ -4126,7 +4395,7 @@ export interface SessionsDevicesProps {
4126
4395
  export declare function SessionsDevices({ sessions, onRevoke, onRevokeOthers, title, description, headingLevel: Heading, className }: SessionsDevicesProps): import("react").JSX.Element;
4127
4396
  //#endregion
4128
4397
  //#region src/team/SessionsDevices/block.meta.d.ts
4129
- declare const meta$60: BlockMeta;
4398
+ declare const meta$61: BlockMeta;
4130
4399
  //#endregion
4131
- 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 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 };
4132
4401
  //# sourceMappingURL=index.d.ts.map