@gntik-ai/blocks 0.8.0 → 0.10.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 (77) hide show
  1. package/dist/index.d.ts +138 -21
  2. package/dist/index.js +897 -376
  3. package/dist/index.js.map +1 -1
  4. package/package.json +3 -3
  5. package/src/billing/CostBreakdown/CostBreakdown.test.tsx +10 -0
  6. package/src/billing/CostBreakdown/CostBreakdown.tsx +50 -43
  7. package/src/billing/SpendVsBudget/SpendVsBudget.test.tsx +10 -0
  8. package/src/billing/SpendVsBudget/SpendVsBudget.tsx +35 -31
  9. package/src/builders/FlowBuilder/FlowBuilder.test.tsx +237 -2
  10. package/src/builders/FlowBuilder/FlowBuilder.tsx +101 -29
  11. package/src/builders/FlowBuilder/block.meta.ts +1 -1
  12. package/src/builders/FlowBuilder/connections.ts +30 -12
  13. package/src/builders/FlowBuilder/examples/ControlledGraph.tsx +8 -0
  14. package/src/builders/FlowBuilder/graph-state.ts +78 -0
  15. package/src/builders/LogViewer/LogViewer.labels.test.tsx +90 -0
  16. package/src/builders/LogViewer/LogViewer.test.tsx +11 -0
  17. package/src/builders/LogViewer/LogViewer.tsx +70 -31
  18. package/src/builders/LogViewer/block.meta.ts +14 -1
  19. package/src/builders/LogViewer/examples/Spanish.tsx +30 -0
  20. package/src/data-display/ChartCard/ChartCard.locale.test.tsx +15 -0
  21. package/src/data-display/ChartCard/ChartCard.test.tsx +9 -0
  22. package/src/data-display/ChartCard/ChartCard.tsx +81 -67
  23. package/src/data-display/ChartCard/block.meta.ts +1 -1
  24. package/src/data-display/DescriptionListCard/DescriptionListCard.labels.test.tsx +73 -0
  25. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +37 -7
  26. package/src/data-display/DescriptionListCard/block.meta.ts +11 -1
  27. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +22 -0
  28. package/src/feedback/EmptyStates/EmptyStates.labels.test.tsx +185 -0
  29. package/src/feedback/EmptyStates/EmptyStates.tsx +73 -20
  30. package/src/feedback/EmptyStates/block.meta.ts +73 -1
  31. package/src/feedback/EmptyStates/examples/Spanish.tsx +41 -0
  32. package/src/feedback/ErrorPanel/ErrorPanel.labels.test.tsx +99 -0
  33. package/src/feedback/ErrorPanel/ErrorPanel.tsx +38 -9
  34. package/src/feedback/ErrorPanel/block.meta.ts +19 -1
  35. package/src/feedback/ErrorPanel/examples/Spanish.tsx +30 -0
  36. package/src/feedback/InlineCallout/InlineCallout.labels.test.tsx +62 -0
  37. package/src/feedback/InlineCallout/InlineCallout.tsx +22 -9
  38. package/src/feedback/InlineCallout/block.meta.ts +9 -1
  39. package/src/feedback/InlineCallout/examples/Spanish.tsx +19 -0
  40. package/src/feedback/Skeletons/Skeletons.labels.test.tsx +24 -0
  41. package/src/forms/FileUploadPanel/FileUploadPanel.test.tsx +22 -1
  42. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +4 -4
  43. package/src/forms/FileUploadPanel/fixtures.ts +0 -12
  44. package/src/forms/FileUploadPanel/format-bytes.test.ts +8 -0
  45. package/src/page-chrome/PageHeader/PageHeader.labels.test.tsx +56 -0
  46. package/src/page-chrome/PageHeader/PageHeader.test.tsx +18 -0
  47. package/src/page-chrome/PageHeader/PageHeader.tsx +21 -4
  48. package/src/page-chrome/PageHeader/block.meta.ts +8 -1
  49. package/src/page-chrome/PageHeader/examples/Labels.tsx +16 -0
  50. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  51. package/src/scheduling/AgendaList/AgendaList.test.tsx +25 -0
  52. package/src/scheduling/AgendaList/AgendaList.tsx +7 -2
  53. package/src/scheduling/AgendaList/AgendaListLocale.test.tsx +11 -0
  54. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  55. package/src/scheduling/AgendaList/examples/Locale.tsx +29 -0
  56. package/src/scheduling/MonthCalendar/MonthCalendar.test.tsx +111 -1
  57. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +19 -9
  58. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  59. package/src/scheduling/MonthCalendar/examples/Locale.tsx +19 -0
  60. package/src/scheduling/WeekCalendar/WeekCalendar.test.tsx +73 -2
  61. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +26 -12
  62. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  63. package/src/scheduling/WeekCalendar/examples/Locale.tsx +19 -0
  64. package/src/scheduling/shared/dates.test.ts +75 -0
  65. package/src/scheduling/shared/dates.ts +46 -22
  66. package/src/scheduling/shared/useSchedulingClock.ts +13 -0
  67. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +12 -0
  68. package/src/shell/GlobalSearch/fixtures.ts +2 -2
  69. package/src/tables/DataTable/DataTable.labels.test.tsx +2 -0
  70. package/src/tables/DataTable/DataTable.locale.test.tsx +153 -0
  71. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +1 -1
  72. package/src/tables/DataTable/DataTable.test.tsx +16 -0
  73. package/src/tables/DataTable/block.meta.ts +2 -0
  74. package/src/tables/DataTable/data-table-row.tsx +18 -2
  75. package/src/tables/DataTable/data-table-utils.ts +18 -4
  76. package/src/tables/DataTable/labels.ts +2 -0
  77. package/src/tables/PaginationFooter/PaginationFooter.i18n.test.tsx +26 -0
package/dist/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
 
2
2
  import { ComponentType, HTMLAttributes, ReactElement, ReactNode, Ref, RefObject } from "react";
3
3
  import { LucideIcon } from "@gntik-ai/icons";
4
- import { AlertTone, BadgeTone, BreadcrumbItem, ButtonProps, CommandItem, CursorPaginationProps, DateInput, DateRange, DateRangePreset, MeterThresholds, MoreMenuAction, NavGroup, NavItem, NotificationItem, SparklineTone, StatusDefinition, StatusDotTone, TableDensity, UserMenuEntry, UserMenuUser, WizardLayoutProps, Workspace } from "@gntik-ai/ui";
4
+ import { AlertTone, BadgeTone, BreadcrumbItem, ButtonProps, CommandItem, CursorPaginationProps, DateInput, DateRange, DateRangePreset, MeterThresholds, MoreMenuAction, NavGroup, NavItem, NotificationItem, SparklineTone, StatusDefinition, StatusDotTone, TableDensity, UserMenuEntry, UserMenuUser, WeekDay, WizardLayoutProps, Workspace } from "@gntik-ai/ui";
5
5
  import { ChartColor, ChartStateProps, HeatmapProps, ValueFormatter } from "@gntik-ai/charts";
6
6
  import { FlowCanvasProps, FlowHandle, FlowNode, FlowNode as FlowNode$1, FlowNodeData, FlowNodeData as FlowNodeData$1, FlowNodeKind, FlowNodeKind as FlowNodeKind$1, FlowNodeRenderProps, FlowNodeRenderer, FlowNodeRenderer as FlowNodeRenderer$1, FlowTone, FlowTone as FlowTone$1 } from "@gntik-ai/flow";
7
7
  import { Monaco, MonacoLoader } from "@gntik-ai/editor";
@@ -862,6 +862,9 @@ interface ConsoleEntry {
862
862
  level: 'info' | 'success' | 'warn' | 'error';
863
863
  message: string;
864
864
  }
865
+ /** Neutral starter flow: webhook → validate → route → notify / store. */
866
+ export declare const builderNodes: FlowNode$1[];
867
+ export declare const builderEdges: FlowEdge[];
865
868
  //#endregion
866
869
  //#region src/builders/FlowBuilder/extensions.d.ts
867
870
  /** Connection plus node type identifiers, for consumer edge mapping and validation. */
@@ -897,10 +900,24 @@ interface FlowBuilderExtensions {
897
900
  }
898
901
  //#endregion
899
902
  //#region src/builders/FlowBuilder/FlowBuilder.d.ts
903
+ export interface FlowGraph<Kind extends string = FlowNodeKind$1> {
904
+ nodes: FlowNode$1<Kind | FlowNodeKind$1>[];
905
+ edges: FlowEdge[];
906
+ }
907
+ export interface FlowGraphChange {
908
+ type: 'add' | 'delete' | 'move' | 'connect' | 'update';
909
+ nodeIds: string[];
910
+ edgeIds: string[];
911
+ }
912
+ /** Persist graph content without canvas selection, drag or measurement state. */
913
+ export declare function cleanFlowGraph<Kind extends string>(graph: FlowGraph<Kind>): FlowGraph<Kind>;
900
914
  export interface FlowBuilderProps<Kind extends string = FlowNodeKind$1> extends FlowBuilderExtensions {
901
915
  title?: string;
902
916
  nodes?: FlowNode$1<Kind | FlowNodeKind$1>[];
903
917
  edges?: FlowEdge[];
918
+ /** Controlled graph content. Canvas selection, measurements and active drags stay local. */
919
+ graph?: FlowGraph<Kind>;
920
+ onGraphChange?: (graph: FlowGraph<Kind>, change: FlowGraphChange) => void;
904
921
  palette?: PaletteItem[];
905
922
  /**
906
923
  * Console output (controlled). Run and Clear then report the next list through
@@ -922,10 +939,7 @@ export interface FlowBuilderProps<Kind extends string = FlowNodeKind$1> extends
922
939
  * of them) to log the real run; return nothing to log a simulated run. While a returned
923
940
  * promise is pending the Run button shows a loading state; a rejection is logged as an error.
924
941
  */
925
- onRun?: (graph: {
926
- nodes: FlowNode$1<Kind | FlowNodeKind$1>[];
927
- edges: FlowEdge[];
928
- }) => FlowRunResult | Promise<FlowRunResult>;
942
+ onRun?: (graph: FlowGraph<Kind>) => FlowRunResult | Promise<FlowRunResult>;
929
943
  className?: string;
930
944
  }
931
945
  /** What `onRun` may return: entries to append, or nothing for the simulated run. */
@@ -935,7 +949,7 @@ export type FlowRunResult = ConsoleEntry[] | void | undefined;
935
949
  * inspector for the selected node and a run console, in resizable panels. On small screens
936
950
  * the panels stack.
937
951
  */
938
- export declare function FlowBuilder<Kind extends string = FlowNodeKind$1>({ title, nodes: initialNodes, edges: initialEdges, palette, consoleEntries, defaultConsoleEntries, onConsoleChange, onConsoleClear, titleAs: TitleTag, height, onRun, nodeTypes, onConnectEdge, onConnect: onConnected, isValidConnection, onConnectionRejected, validationIssues, mode, nodeStatus, onNodeSelect, className }: FlowBuilderProps<Kind>): import("react").JSX.Element;
952
+ export declare function FlowBuilder<Kind extends string = FlowNodeKind$1>({ title, nodes: initialNodes, edges: initialEdges, graph, onGraphChange, palette, consoleEntries, defaultConsoleEntries, onConsoleChange, onConsoleClear, titleAs: TitleTag, height, onRun, nodeTypes, onConnectEdge, onConnect: onConnected, isValidConnection, onConnectionRejected, validationIssues, mode, nodeStatus, onNodeSelect, className }: FlowBuilderProps<Kind>): import("react").JSX.Element;
939
953
  //#endregion
940
954
  //#region src/builders/FlowBuilder/parts.d.ts
941
955
  /** Heading level of a panel title (one below the builder's title). */
@@ -1054,7 +1068,21 @@ interface LogLine {
1054
1068
  //#endregion
1055
1069
  //#region src/builders/LogViewer/LogViewer.d.ts
1056
1070
  export declare const LOG_LEVELS: LogLevel[];
1071
+ export interface LogViewerLabels {
1072
+ title: string;
1073
+ levelFilter: string;
1074
+ searchLabel: string;
1075
+ searchPlaceholder: string;
1076
+ follow: string;
1077
+ count: (visible: number, total: number) => string;
1078
+ empty: string;
1079
+ inspect: (timestamp: string) => string;
1080
+ copy: (timestamp: string) => string;
1081
+ copied: string;
1082
+ }
1057
1083
  export interface LogViewerProps {
1084
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
1085
+ labels?: Partial<LogViewerLabels>;
1058
1086
  /** Log lines, oldest first. */
1059
1087
  lines?: LogLine[];
1060
1088
  /** Accessible name of the log region and visible title. */
@@ -1086,7 +1114,7 @@ export interface LogViewerProps {
1086
1114
  * so it stays fast with thousands of lines. Level filter, search with highlighted matches,
1087
1115
  * follow-tail and per-line copy.
1088
1116
  */
1089
- export declare function LogViewer({ lines, title, height, rowHeight, overscan, defaultLevels, defaultFollow, onCopyLine, onSelectLine, selectedLineId, announceLines, titleAs: TitleTag, className }: LogViewerProps): import("react").JSX.Element;
1117
+ export declare function LogViewer({ lines, title: titleProp, labels, height, rowHeight, overscan, defaultLevels, defaultFollow, onCopyLine, onSelectLine, selectedLineId, announceLines, titleAs: TitleTag, className }: LogViewerProps): import("react").JSX.Element;
1090
1118
  //#endregion
1091
1119
  //#region src/builders/LogViewer/block.meta.d.ts
1092
1120
  declare const meta$40: BlockMeta;
@@ -1301,7 +1329,17 @@ export interface DescriptionItem {
1301
1329
  copyable?: boolean;
1302
1330
  copyValue?: string;
1303
1331
  }
1332
+ export interface DescriptionListCardLabels {
1333
+ title: string;
1334
+ description: string;
1335
+ edit: string;
1336
+ copy: (label: string) => string;
1337
+ copied: (label: string) => string;
1338
+ copiedToClipboard: string;
1339
+ }
1304
1340
  export interface DescriptionListCardProps {
1341
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
1342
+ labels?: Partial<DescriptionListCardLabels>;
1305
1343
  title?: string;
1306
1344
  description?: string;
1307
1345
  items?: readonly DescriptionItem[];
@@ -1315,7 +1353,7 @@ export interface DescriptionListCardProps {
1315
1353
  className?: string;
1316
1354
  }
1317
1355
  /** Key–value detail card: label column, values (mono, status or rich), copy buttons and an Edit action. */
1318
- export declare function DescriptionListCard({ title, description, items, onEdit, editLabel, onCopy, titleAs, className }: DescriptionListCardProps): import("react").JSX.Element;
1356
+ export declare function DescriptionListCard({ title: titleProp, labels, description: descriptionProp, items, onEdit, editLabel: editLabelProp, onCopy, titleAs, className }: DescriptionListCardProps): import("react").JSX.Element;
1319
1357
  //#endregion
1320
1358
  //#region src/data-display/DescriptionListCard/block.meta.d.ts
1321
1359
  declare const meta$19: BlockMeta;
@@ -1532,7 +1570,15 @@ export declare function SystemBanner({ kind, title, message, action, dismissible
1532
1570
  declare const meta$71: BlockMeta;
1533
1571
  //#endregion
1534
1572
  //#region src/feedback/InlineCallout/InlineCallout.d.ts
1573
+ export interface InlineCalloutLabels {
1574
+ title: string;
1575
+ description: string;
1576
+ upgrade: string;
1577
+ viewUsage: string;
1578
+ }
1535
1579
  export interface InlineCalloutProps {
1580
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
1581
+ labels?: Partial<InlineCalloutLabels>;
1536
1582
  tone?: AlertTone;
1537
1583
  title?: ReactNode;
1538
1584
  description?: ReactNode;
@@ -1547,7 +1593,7 @@ export interface InlineCalloutProps {
1547
1593
  className?: string;
1548
1594
  }
1549
1595
  /** In-content callout built on Alert: tone, title, body and a row of actions. */
1550
- export declare function InlineCallout({ tone, title, description, actions, icon, dismissible, open, onDismiss, className }: InlineCalloutProps): import("react").JSX.Element | null;
1596
+ export declare function InlineCallout({ tone, title: titleProp, labels, description: descriptionProp, actions: actionsProp, icon, dismissible, open, onDismiss, className }: InlineCalloutProps): import("react").JSX.Element | null;
1551
1597
  //#endregion
1552
1598
  //#region src/feedback/InlineCallout/block.meta.d.ts
1553
1599
  declare const meta$34: BlockMeta;
@@ -1568,7 +1614,15 @@ export interface NotFoundEmptyProps extends SharedEmptyProps {
1568
1614
  }
1569
1615
  /** Missing resource state; consumers may supply an optional way back. */
1570
1616
  export declare function NotFoundEmpty({ icon, title, description, action, titleAs, bordered, className }: NotFoundEmptyProps): import("react").JSX.Element;
1617
+ export interface FirstRunEmptyLabels {
1618
+ title: string;
1619
+ description: string;
1620
+ action: string;
1621
+ guide: string;
1622
+ }
1571
1623
  export interface FirstRunEmptyProps extends SharedEmptyProps {
1624
+ /** Per-key copy overrides; explicit props take precedence over labels and catalog defaults. */
1625
+ labels?: Partial<FirstRunEmptyLabels>;
1572
1626
  icon?: LucideIcon;
1573
1627
  title?: ReactNode;
1574
1628
  description?: ReactNode;
@@ -1583,8 +1637,18 @@ export interface FirstRunEmptyProps extends SharedEmptyProps {
1583
1637
  steps?: string[];
1584
1638
  }
1585
1639
  /** First-run state: nothing created yet; explains the value and offers the first action. */
1586
- export declare function FirstRunEmpty({ icon, title, description, actionLabel, onAction, secondary, steps, titleAs, bordered, className }: FirstRunEmptyProps): import("react").JSX.Element;
1640
+ export declare function FirstRunEmpty({ icon, title: titleProp, labels, description: descriptionProp, actionLabel: actionLabelProp, onAction, secondary: secondaryProp, steps, titleAs, bordered, className }: FirstRunEmptyProps): import("react").JSX.Element;
1641
+ export interface NoResultsEmptyLabels {
1642
+ /** Replaces the complete query heading; catalog defaults retain the query’s monospace span. */
1643
+ queryTitle: (entity: string, query: string) => string;
1644
+ title: (entity: string) => string;
1645
+ description: (filterCount: number) => string;
1646
+ clearFilters: string;
1647
+ clearSearch: string;
1648
+ }
1587
1649
  export interface NoResultsEmptyProps extends SharedEmptyProps {
1650
+ /** Per-key overrides; formatter arguments are caller data and results render verbatim. */
1651
+ labels?: Partial<NoResultsEmptyLabels>;
1588
1652
  /** The search text that matched nothing. */
1589
1653
  query?: string;
1590
1654
  /** Number of active filters (shows "Clear filters" when > 0). */
@@ -1595,8 +1659,17 @@ export interface NoResultsEmptyProps extends SharedEmptyProps {
1595
1659
  onClearSearch?: () => void;
1596
1660
  }
1597
1661
  /** No-results state for a filtered list or table: echoes the query and offers ways out. */
1598
- export declare function NoResultsEmpty({ query, filterCount, entity, onClearFilters, onClearSearch, titleAs, bordered, className }: NoResultsEmptyProps): import("react").JSX.Element;
1662
+ export declare function NoResultsEmpty({ query, labels, filterCount, entity, onClearFilters, onClearSearch, titleAs, bordered, className }: NoResultsEmptyProps): import("react").JSX.Element;
1663
+ export interface NoAccessEmptyLabels {
1664
+ title: (resource: string) => string;
1665
+ description: (resource: string, owner: string) => string;
1666
+ request: string;
1667
+ requested: string;
1668
+ sent: string;
1669
+ }
1599
1670
  export interface NoAccessEmptyProps extends SharedEmptyProps {
1671
+ /** Per-key overrides; formatters receive the original resource and owner, without translation. */
1672
+ labels?: Partial<NoAccessEmptyLabels>;
1600
1673
  /** What the viewer cannot see. */
1601
1674
  resource?: string;
1602
1675
  /** Who can grant access. */
@@ -1607,7 +1680,7 @@ export interface NoAccessEmptyProps extends SharedEmptyProps {
1607
1680
  defaultRequested?: boolean;
1608
1681
  }
1609
1682
  /** Permission state: the viewer lacks access; explains who can grant it and lets them ask. */
1610
- export declare function NoAccessEmpty({ resource, owner, onRequestAccess, defaultRequested, titleAs, bordered, className }: NoAccessEmptyProps): import("react").JSX.Element;
1683
+ export declare function NoAccessEmpty({ resource, labels, owner, onRequestAccess, defaultRequested, titleAs, bordered, className }: NoAccessEmptyProps): import("react").JSX.Element;
1611
1684
  //#endregion
1612
1685
  //#region src/feedback/EmptyStates/fixtures.d.ts
1613
1686
  /** Neutral sample copy for the empty states. */
@@ -1711,7 +1784,22 @@ export declare function ConfirmDestructive({ resourceName, resourceType, title,
1711
1784
  declare const meta$11: BlockMeta;
1712
1785
  //#endregion
1713
1786
  //#region src/feedback/ErrorPanel/ErrorPanel.d.ts
1787
+ export interface ErrorPanelLabels {
1788
+ title: string;
1789
+ message: string;
1790
+ support: string;
1791
+ retry: string;
1792
+ retrying: string;
1793
+ retryingStatus: string;
1794
+ requestId: string;
1795
+ copyRequestId: string;
1796
+ copied: string;
1797
+ requestIdCopied: string;
1798
+ details: string;
1799
+ }
1714
1800
  export interface ErrorPanelProps {
1801
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
1802
+ labels?: Partial<ErrorPanelLabels>;
1715
1803
  icon?: LucideIcon;
1716
1804
  title?: ReactNode;
1717
1805
  /** Human summary of what failed and what to do. */
@@ -1735,7 +1823,7 @@ export interface ErrorPanelProps {
1735
1823
  announce?: boolean;
1736
1824
  }
1737
1825
  /** Error summary for a failed load or action: what happened, request id, retry and technical details. */
1738
- export declare function ErrorPanel({ icon: Icon, title, message, code, requestId, details, onRetry, retrying, retryLabel: retryLabelProp, secondaryAction, titleAs: Heading, className, announce }: ErrorPanelProps): import("react").JSX.Element;
1826
+ export declare function ErrorPanel({ icon: Icon, title: titleProp, labels, message: messageProp, code, requestId, details, onRetry, retrying, retryLabel: retryLabelProp, secondaryAction: secondaryActionProp, titleAs: Heading, className, announce }: ErrorPanelProps): import("react").JSX.Element;
1739
1827
  //#endregion
1740
1828
  //#region src/feedback/ErrorPanel/block.meta.d.ts
1741
1829
  declare const meta$23: BlockMeta;
@@ -2384,7 +2472,15 @@ export interface PageHeaderTab {
2384
2472
  label: string;
2385
2473
  count?: number;
2386
2474
  }
2475
+ export interface PageHeaderLabels {
2476
+ title: string;
2477
+ description: string;
2478
+ moreActions: string;
2479
+ sections: string;
2480
+ }
2387
2481
  export interface PageHeaderProps {
2482
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
2483
+ labels?: Partial<PageHeaderLabels>;
2388
2484
  /** Root element. Use 'div' where the layout already has a banner (e.g. StackedLayout's pageHeader slot). */
2389
2485
  as?: 'header' | 'div';
2390
2486
  /** Location trail above the title; `null` hides it. */
@@ -2411,7 +2507,7 @@ export interface PageHeaderProps {
2411
2507
  className?: string;
2412
2508
  }
2413
2509
  /** Screen header: breadcrumb, title + status, description, meta row, actions and optional tabs. */
2414
- export declare function PageHeader({ as: Root, breadcrumbs, title, titleRef, description, status, statuses, meta, actions, tabs, tab, defaultTab, onTabChange, className }: PageHeaderProps): import("react").JSX.Element;
2510
+ export declare function PageHeader({ as: Root, breadcrumbs, title: titleProp, labels, titleRef, description: descriptionProp, status, statuses, meta, actions, tabs, tab, defaultTab, onTabChange, className }: PageHeaderProps): import("react").JSX.Element;
2415
2511
  //#endregion
2416
2512
  //#region src/page-chrome/PageHeader/fixtures.d.ts
2417
2513
  export declare const pageHeaderBreadcrumbs: BreadcrumbItem[];
@@ -2526,6 +2622,10 @@ export declare function BulkActionBar({ selectedCount, totalCount, noun: nounPro
2526
2622
  //#region src/page-chrome/BulkActionBar/block.meta.d.ts
2527
2623
  declare const meta$6: BlockMeta;
2528
2624
  //#endregion
2625
+ //#region src/scheduling/shared/dates.d.ts
2626
+ /** The clock options accepted by the scheduling blocks. */
2627
+ type HourCycle = 'h12' | 'h23';
2628
+ //#endregion
2529
2629
  //#region src/scheduling/shared/events.d.ts
2530
2630
  /** A scheduled item on a calendar. */
2531
2631
  interface ScheduleEvent {
@@ -2550,6 +2650,10 @@ export declare const defaultEventKinds: Record<string, EventKind>;
2550
2650
  //#region src/scheduling/MonthCalendar/MonthCalendar.d.ts
2551
2651
  export interface MonthCalendarProps {
2552
2652
  events?: ScheduleEvent[];
2653
+ /** Clock used for event times; defaults to the provider or runtime locale. */
2654
+ hourCycle?: HourCycle;
2655
+ /** First weekday; defaults to the provider or runtime locale. */
2656
+ weekStartsOn?: WeekDay;
2553
2657
  /** The app's "today" (the block never reads the clock). */
2554
2658
  today?: Date;
2555
2659
  /** Month shown first (uncontrolled). Defaults to the month of `today`. */
@@ -2568,11 +2672,11 @@ export interface MonthCalendarProps {
2568
2672
  className?: string;
2569
2673
  }
2570
2674
  /**
2571
- * Month view of scheduled work: a Monday-first grid with up to N events per day.
2675
+ * Month view of scheduled work: a locale-first grid with up to N events per day.
2572
2676
  * Keyboard: arrows move by day/week, Home/End to the week edges, PageUp/PageDown by month,
2573
2677
  * Enter/Space selects.
2574
2678
  */
2575
- export declare function MonthCalendar({ events, today, defaultMonth, onMonthChange, defaultSelected, onSelectDate, kinds, maxEventsPerDay, actions, className }: MonthCalendarProps): import("react").JSX.Element;
2679
+ export declare function MonthCalendar({ events, hourCycle: hourCycleProp, weekStartsOn: weekStartsOnProp, today, defaultMonth, onMonthChange, defaultSelected, onSelectDate, kinds, maxEventsPerDay, actions, className }: MonthCalendarProps): import("react").JSX.Element;
2576
2680
  //#endregion
2577
2681
  //#region src/scheduling/MonthCalendar/block.meta.d.ts
2578
2682
  declare const meta$44: BlockMeta;
@@ -2580,13 +2684,17 @@ declare const meta$44: BlockMeta;
2580
2684
  //#region src/scheduling/WeekCalendar/WeekCalendar.d.ts
2581
2685
  export interface WeekCalendarProps {
2582
2686
  events?: ScheduleEvent[];
2687
+ /** First weekday; defaults to the provider or runtime locale. */
2688
+ weekStartsOn?: WeekDay;
2689
+ /** Clock used for events and hour labels; defaults to the provider or runtime locale. */
2690
+ hourCycle?: HourCycle;
2583
2691
  /** The app's "today" (the block never reads the clock). */
2584
2692
  today?: Date;
2585
2693
  /** Current time for the "now" line, shown when it falls in the visible week. Defaults to `today`. */
2586
2694
  now?: Date;
2587
2695
  /** A date inside the week shown first (uncontrolled). Defaults to `today`. */
2588
2696
  defaultWeek?: Date;
2589
- /** Called with the Monday of the newly shown week. */
2697
+ /** Called with the first day of the newly shown week. */
2590
2698
  onWeekChange?: (weekStart: Date) => void;
2591
2699
  /** Makes events buttons. */
2592
2700
  onEventClick?: (event: ScheduleEvent) => void;
@@ -2601,7 +2709,7 @@ export interface WeekCalendarProps {
2601
2709
  className?: string;
2602
2710
  }
2603
2711
  /** Week view: seven day columns over a scrolling 24-hour time grid, with a "now" line. */
2604
- export declare function WeekCalendar({ events, today, now, defaultWeek, onWeekChange, onEventClick, kinds, scrollToHour, hourHeight, height, actions, className }: WeekCalendarProps): import("react").JSX.Element;
2712
+ export declare function WeekCalendar({ events, weekStartsOn: weekStartsOnProp, hourCycle: hourCycleProp, today, now, defaultWeek, onWeekChange, onEventClick, kinds, scrollToHour, hourHeight, height, actions, className }: WeekCalendarProps): import("react").JSX.Element;
2605
2713
  //#endregion
2606
2714
  //#region src/scheduling/WeekCalendar/block.meta.d.ts
2607
2715
  declare const meta$77: BlockMeta;
@@ -2609,6 +2717,8 @@ declare const meta$77: BlockMeta;
2609
2717
  //#region src/scheduling/AgendaList/AgendaList.d.ts
2610
2718
  export interface AgendaListProps {
2611
2719
  events?: ScheduleEvent[];
2720
+ /** Clock used for event ranges; defaults to the provider or runtime locale. */
2721
+ hourCycle?: HourCycle;
2612
2722
  /** The app's "today": labels the Today/Tomorrow groups. */
2613
2723
  today?: Date;
2614
2724
  /** Only events on or after this day. Defaults to `today`; pass null for all. */
@@ -2628,7 +2738,7 @@ export interface AgendaListProps {
2628
2738
  className?: string;
2629
2739
  }
2630
2740
  /** Upcoming scheduled work grouped by day, each row with a kind tile, time range and location. */
2631
- export declare function AgendaList({ events, today, from, days, onEventClick, kinds, title: titleProp, maxHeight, emptyTitle: emptyTitleProp, emptyDescription: emptyDescriptionProp, titleAs: TitleTag, className }: AgendaListProps): import("react").JSX.Element;
2741
+ export declare function AgendaList({ events, hourCycle: hourCycleProp, today, from, days, onEventClick, kinds, title: titleProp, maxHeight, emptyTitle: emptyTitleProp, emptyDescription: emptyDescriptionProp, titleAs: TitleTag, className }: AgendaListProps): import("react").JSX.Element;
2632
2742
  //#endregion
2633
2743
  //#region src/scheduling/AgendaList/block.meta.d.ts
2634
2744
  declare const meta$2: BlockMeta;
@@ -2924,8 +3034,13 @@ export declare function selectionState(visibleIds: readonly string[], selected:
2924
3034
  /** Selects all of `ids` when not all are selected; otherwise clears them. Other selections are kept. */
2925
3035
  export declare function toggleAll(ids: readonly string[], selected: ReadonlySet<string>): Set<string>;
2926
3036
  export declare function toggleOne(id: string, selected: ReadonlySet<string>): Set<string>;
2927
- /** Default cell text for a raw value. */
2928
- export declare function formatCell(value: CellValue): ReactNode;
3037
+ /** Optional locale and boolean text for default cells. */
3038
+ export interface DataTableCellFormatOptions {
3039
+ locale?: string;
3040
+ booleanLabels?: [trueLabel: string, falseLabel: string];
3041
+ }
3042
+ /** Default cell text for a raw value. Omitting options preserves the legacy output. */
3043
+ export declare function formatCell(value: CellValue, options?: DataTableCellFormatOptions): ReactNode;
2929
3044
  /** Groups rows by a field key or by a function returning the group key. */
2930
3045
  export type DataTableGroupBy<T> = Extract<keyof T, string> | ((row: T) => string | number | null | undefined);
2931
3046
  /** One group of rows, in display order. */
@@ -2998,6 +3113,8 @@ export declare function PaginationFooter({ total, page: pageProp, defaultPage, o
2998
3113
  //#region src/tables/DataTable/labels.d.ts
2999
3114
  /** Per-instance table chrome, including the composed PaginationFooter. Caller data stays caller-owned. */
3000
3115
  interface DataTableLabels extends PaginationFooterLabels {
3116
+ booleanTrue: string;
3117
+ booleanFalse: string;
3001
3118
  /** Non-virtual table overflow region; virtualized regions keep the caller caption. */
3002
3119
  scrollRegion: string;
3003
3120
  selectionCount: (count: number) => string;