@box-kite/react 2.2.4 → 2.2.6

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 (167) hide show
  1. package/.claude/rules/box-kite-rules.md +11 -1
  2. package/.claude/skills/box-kite/SKILL.md +11 -1
  3. package/.claude/skills/box-kite/references/components.md +83 -3
  4. package/.cursor/rules/box-kite.mdc +11 -1
  5. package/AGENTS.md +11 -1
  6. package/BOX_AI_CONTEXT.md +371 -25
  7. package/BOX_KITE_AI_CONTEXT.md +371 -25
  8. package/behavior.cjs +1 -1
  9. package/behavior.mjs +57 -57
  10. package/box.cjs +1 -1
  11. package/box.d.ts +5 -0
  12. package/box.mjs +15 -15
  13. package/catalog.cjs +1 -1
  14. package/catalog.mjs +906 -0
  15. package/client.cjs +1 -1
  16. package/client.mjs +94 -80
  17. package/components/calendar.cjs +1 -0
  18. package/components/calendar.d.ts +77 -0
  19. package/components/calendar.mjs +483 -0
  20. package/components/dashboard.cjs +1 -1
  21. package/components/dashboard.mjs +1 -1
  22. package/components/dataGrid/components/dataGridBooleanValue.d.ts +11 -0
  23. package/components/dataGrid/components/dataGridDateParts.d.ts +40 -0
  24. package/components/dataGrid/components/dataGridDateValue.d.ts +14 -0
  25. package/components/dataGrid/components/dataGridList.d.ts +12 -0
  26. package/components/dataGrid/components/dataGridListAggregate.d.ts +7 -0
  27. package/components/dataGrid/components/dataGridListFilter.d.ts +7 -0
  28. package/components/dataGrid/components/dataGridListFilterSheet.d.ts +11 -0
  29. package/components/dataGrid/components/dataGridListFooter.d.ts +13 -0
  30. package/components/dataGrid/components/dataGridListGroup.d.ts +13 -0
  31. package/components/dataGrid/components/dataGridListItem.d.ts +21 -0
  32. package/components/dataGrid/components/dataGridListLayout.d.ts +20 -0
  33. package/components/dataGrid/components/dataGridListRecord.d.ts +11 -0
  34. package/components/dataGrid/components/dataGridListSelectionBar.d.ts +11 -0
  35. package/components/dataGrid/components/dataGridListSheet.d.ts +30 -0
  36. package/components/dataGrid/components/dataGridListSortSheet.d.ts +10 -0
  37. package/components/dataGrid/components/dataGridListToolbar.d.ts +10 -0
  38. package/components/dataGrid/components/dataGridListValue.d.ts +12 -0
  39. package/components/dataGrid/contracts/dataGridContract.d.ts +70 -11
  40. package/components/dataGrid/models/columnModel.d.ts +3 -1
  41. package/components/dataGrid/models/editModel.d.ts +3 -1
  42. package/components/dataGrid/models/gridModel.d.ts +3 -0
  43. package/components/dataGrid/models/listModel.d.ts +129 -0
  44. package/components/dataGrid/models/localeText.d.ts +36 -0
  45. package/components/dataGrid/models/viewportModel.d.ts +0 -2
  46. package/components/dataGrid/useDateParts.d.ts +17 -0
  47. package/components/dataGrid/useListLayout.d.ts +13 -0
  48. package/components/dataGrid.cjs +3 -3
  49. package/components/dataGrid.mjs +1251 -854
  50. package/components/dateField.cjs +1 -0
  51. package/components/dateField.d.ts +78 -0
  52. package/components/dateField.mjs +313 -0
  53. package/components/datePicker.cjs +1 -0
  54. package/components/datePicker.d.ts +120 -0
  55. package/components/datePicker.mjs +529 -0
  56. package/components/dateTime.cjs +1 -0
  57. package/components/dateTime.d.ts +23 -0
  58. package/components/dateTime.mjs +34 -0
  59. package/components/dialog.cjs +1 -1
  60. package/components/dialog.mjs +29 -29
  61. package/components/list/listItemParts.d.ts +9 -0
  62. package/components/list.cjs +1 -0
  63. package/components/list.d.ts +118 -0
  64. package/components/list.mjs +391 -0
  65. package/components/menu.cjs +1 -1
  66. package/components/menu.mjs +25 -25
  67. package/components/overlay.cjs +1 -1
  68. package/components/overlay.mjs +12 -12
  69. package/components/semantics.d.ts +29 -29
  70. package/components/slider.cjs +1 -1
  71. package/components/slider.mjs +1 -1
  72. package/components/sortableList.cjs +1 -0
  73. package/components/sortableList.d.ts +49 -0
  74. package/components/sortableList.mjs +384 -0
  75. package/components/swipeItem.cjs +1 -0
  76. package/components/swipeItem.d.ts +52 -0
  77. package/components/swipeItem.mjs +321 -0
  78. package/components/tabs.cjs +1 -1
  79. package/components/tabs.mjs +1 -1
  80. package/components/timeZoneSelect.cjs +1 -0
  81. package/components/timeZoneSelect.d.ts +52 -0
  82. package/components/timeZoneSelect.mjs +74 -0
  83. package/components/toaster.cjs +1 -1
  84. package/components/toaster.mjs +24 -24
  85. package/components/virtualList.cjs +1 -0
  86. package/components/virtualList.d.ts +32 -0
  87. package/components/virtualList.mjs +188 -0
  88. package/dataGridDateParts.cjs +1 -0
  89. package/dataGridDateParts.mjs +223 -0
  90. package/dataGridList.cjs +1 -0
  91. package/dataGridList.mjs +1314 -0
  92. package/dataGridListLayout.cjs +1 -0
  93. package/dataGridListLayout.mjs +49 -0
  94. package/date-environment.cjs +1 -0
  95. package/date-environment.mjs +29 -0
  96. package/date-input.cjs +1 -0
  97. package/date-input.mjs +346 -0
  98. package/date-math.cjs +1 -0
  99. package/date-math.mjs +317 -0
  100. package/date.cjs +1 -0
  101. package/date.d.ts +40 -0
  102. package/date.mjs +4 -0
  103. package/dates.cjs +1 -0
  104. package/dates.mjs +689 -0
  105. package/docs/components.md +10 -1
  106. package/icons/closeIcon.d.ts +2 -0
  107. package/icons/filterIcon.d.ts +2 -0
  108. package/layer.cjs +1 -1
  109. package/layer.mjs +1 -1
  110. package/mcp/src/data.d.ts +2 -0
  111. package/package.json +178 -22
  112. package/placement.cjs +1 -1
  113. package/placement.mjs +10 -10
  114. package/platform.cjs +1 -1
  115. package/platform.mjs +4 -1
  116. package/react/a11y/useControllableState.d.ts +2 -1
  117. package/react/boxComponent.d.ts +1 -1
  118. package/react/componentsContext.d.ts +4 -0
  119. package/react/componentsProvider.d.ts +10 -0
  120. package/react/date/dateChange.d.ts +18 -0
  121. package/react/date/dateEnvironment.d.ts +34 -0
  122. package/react/resolveStyles.d.ts +2 -1
  123. package/react/theme/theme.d.ts +6 -1
  124. package/react-shared.cjs +1 -1
  125. package/react-shared.mjs +6 -6
  126. package/registry/blocks/dashboard-shell/dashboard-shell.d.ts +3 -1
  127. package/registry/designs/store/address-form.d.ts +11 -0
  128. package/registry/designs/store/cart-items.d.ts +10 -0
  129. package/registry/designs/store/cart-page.d.ts +4 -0
  130. package/registry/designs/store/checkout-page.d.ts +7 -0
  131. package/registry/designs/store/credit-card-form.d.ts +10 -0
  132. package/registry/designs/store/form-field.d.ts +19 -0
  133. package/registry/designs/store/order-summary.d.ts +18 -0
  134. package/registry/designs/store/product-art.d.ts +26 -0
  135. package/registry/designs/store/product-card.d.ts +11 -0
  136. package/registry/designs/store/product-gallery.d.ts +11 -0
  137. package/registry/designs/store/product-grid.d.ts +10 -0
  138. package/registry/designs/store/product-page.d.ts +5 -0
  139. package/registry/designs/store/quantity-stepper.d.ts +13 -0
  140. package/registry/designs/store/shipping-method.d.ts +14 -0
  141. package/registry/designs/store/store-data.d.ts +53 -0
  142. package/registry/designs/store/store-design.d.ts +63 -0
  143. package/registry/designs/store/store-shell.d.ts +12 -0
  144. package/registry/designs/store/storefront-page.d.ts +4 -0
  145. package/registry/designs/store/variant-picker.d.ts +15 -0
  146. package/rsc.cjs +1 -1
  147. package/rsc.d.ts +2 -0
  148. package/rsc.mjs +1 -1
  149. package/scrolling.cjs +1 -0
  150. package/scrolling.mjs +22 -0
  151. package/utils/date/calendar.d.ts +44 -0
  152. package/utils/date/calendarModel.d.ts +46 -0
  153. package/utils/date/dateTime.d.ts +144 -0
  154. package/utils/date/fieldModel.d.ts +74 -0
  155. package/utils/date/format.d.ts +39 -0
  156. package/utils/date/iso.d.ts +40 -0
  157. package/utils/date/locale.d.ts +17 -0
  158. package/utils/date/parse.d.ts +20 -0
  159. package/utils/date/settings.d.ts +26 -0
  160. package/utils/date/value.d.ts +43 -0
  161. package/utils/date/zoneOptions.d.ts +19 -0
  162. package/utils/date/zones.d.ts +32 -0
  163. package/utils/scroll/scrollUtils.d.ts +6 -0
  164. package/utils/sortable/sortableUtils.d.ts +25 -0
  165. package/utils/swipe/swipeUtils.d.ts +53 -0
  166. package/utils/virtual/measuredWindow.d.ts +28 -0
  167. package/utils/virtual/rowSearch.d.ts +11 -0
package/catalog.mjs CHANGED
@@ -1615,6 +1615,391 @@ var a = i, o = {
1615
1615
  required: [],
1616
1616
  styled: !0
1617
1617
  },
1618
+ List: {
1619
+ description: "A list of things to read and pick from — messages, orders, people, settings.",
1620
+ import: "import List from '@box-kite/react/components/list';",
1621
+ slots: ["default"],
1622
+ events: [],
1623
+ props: { tag: {
1624
+ type: "string",
1625
+ enum: ["ul", "ol"],
1626
+ description: "`ol` when the order means something — steps, a ranking."
1627
+ } },
1628
+ required: [],
1629
+ styled: !0
1630
+ },
1631
+ "List.Item": {
1632
+ description: "One thing in the list: a flex row of its parts.",
1633
+ import: "import List from '@box-kite/react/components/list';",
1634
+ slots: ["default"],
1635
+ events: [],
1636
+ props: {
1637
+ size: {
1638
+ type: "string",
1639
+ enum: [
1640
+ "sm",
1641
+ "md",
1642
+ "lg"
1643
+ ],
1644
+ description: "The item's spacing."
1645
+ },
1646
+ wrap: {
1647
+ type: "boolean",
1648
+ description: "Lets the item's parts wrap onto a second line when they do not fit, instead of squeezing."
1649
+ },
1650
+ selected: {
1651
+ type: "boolean",
1652
+ description: "Tints the item as chosen."
1653
+ },
1654
+ chevron: {
1655
+ type: "boolean",
1656
+ description: "Ends the item with a chevron: pressing it goes somewhere with more."
1657
+ }
1658
+ },
1659
+ required: [],
1660
+ styled: !0
1661
+ },
1662
+ "List.Media": {
1663
+ description: "The leading slot: an icon, an avatar, a thumbnail — `variant` is `icon`, `avatar` or `image`, or none for a bare icon.",
1664
+ import: "import List from '@box-kite/react/components/list';",
1665
+ slots: ["default"],
1666
+ events: [],
1667
+ props: {},
1668
+ required: [],
1669
+ styled: !0
1670
+ },
1671
+ "List.Content": {
1672
+ description: "The middle of an item, taking the room: a column of rows and text, which may shrink past its content.",
1673
+ import: "import List from '@box-kite/react/components/list';",
1674
+ slots: ["default"],
1675
+ events: [],
1676
+ props: {},
1677
+ required: [],
1678
+ styled: !0
1679
+ },
1680
+ "List.Row": {
1681
+ description: "A row inside `List.Content`: its parts side by side, the last at the end.",
1682
+ import: "import List from '@box-kite/react/components/list';",
1683
+ slots: ["default"],
1684
+ events: [],
1685
+ props: {
1686
+ wrap: {
1687
+ type: "boolean",
1688
+ description: "Lets the row's parts wrap onto a new line — a set of tags — instead of pushing the last to the end."
1689
+ },
1690
+ secondary: {
1691
+ type: "boolean",
1692
+ description: "The quieter line under the main one: smaller and muted."
1693
+ }
1694
+ },
1695
+ required: [],
1696
+ styled: !0
1697
+ },
1698
+ "List.Overline": {
1699
+ description: "A small line above the title: an id, a date, a category.",
1700
+ import: "import List from '@box-kite/react/components/list';",
1701
+ slots: ["default"],
1702
+ events: [],
1703
+ props: { lines: {
1704
+ type: "number",
1705
+ enum: [
1706
+ 1,
1707
+ 2,
1708
+ 3
1709
+ ],
1710
+ description: "How many lines it runs to before it stops: `1` ends in an ellipsis, `2` and `3` are clamped."
1711
+ } },
1712
+ required: [],
1713
+ styled: !0
1714
+ },
1715
+ "List.Title": {
1716
+ description: "The item's name, and where its `List.Action` goes.",
1717
+ import: "import List from '@box-kite/react/components/list';",
1718
+ slots: ["default"],
1719
+ events: [],
1720
+ props: { lines: {
1721
+ type: "number",
1722
+ enum: [
1723
+ 1,
1724
+ 2,
1725
+ 3
1726
+ ],
1727
+ description: "How many lines it runs to before it stops: `1` ends in an ellipsis, `2` and `3` are clamped."
1728
+ } },
1729
+ required: [],
1730
+ styled: !0
1731
+ },
1732
+ "List.Description": {
1733
+ description: "Muted supporting text under the title.",
1734
+ import: "import List from '@box-kite/react/components/list';",
1735
+ slots: ["default"],
1736
+ events: [],
1737
+ props: { lines: {
1738
+ type: "number",
1739
+ enum: [
1740
+ 1,
1741
+ 2,
1742
+ 3
1743
+ ],
1744
+ description: "How many lines it runs to before it stops: `1` ends in an ellipsis, `2` and `3` are clamped."
1745
+ } },
1746
+ required: [],
1747
+ styled: !0
1748
+ },
1749
+ "List.Meta": {
1750
+ description: "A small muted value that never wraps — a time, a count — in tabular figures.",
1751
+ import: "import List from '@box-kite/react/components/list';",
1752
+ slots: ["default"],
1753
+ events: [],
1754
+ props: {},
1755
+ required: [],
1756
+ styled: !0
1757
+ },
1758
+ "List.End": {
1759
+ description: "The trailing slot: a value and its label, stacked and aligned to the end so a column of them lines up.",
1760
+ import: "import List from '@box-kite/react/components/list';",
1761
+ slots: ["default"],
1762
+ events: [],
1763
+ props: {},
1764
+ required: [],
1765
+ styled: !0
1766
+ },
1767
+ "List.Actions": {
1768
+ description: "Controls of the item's own — a switch, a menu, a checkbox — lifted above the action that covers the item.",
1769
+ import: "import List from '@box-kite/react/components/list';",
1770
+ slots: ["default"],
1771
+ events: [],
1772
+ props: {},
1773
+ required: [],
1774
+ styled: !0
1775
+ },
1776
+ "List.Action": {
1777
+ description: "The item's one primary action, stretched over the whole item.",
1778
+ import: "import List from '@box-kite/react/components/list';",
1779
+ slots: ["default"],
1780
+ events: ["onClick"],
1781
+ props: { tag: {
1782
+ type: "string",
1783
+ enum: [
1784
+ "button",
1785
+ "a",
1786
+ "label"
1787
+ ],
1788
+ description: "The element, when what `props` holds does not already say: `a` with no `href` is a placeholder link."
1789
+ } },
1790
+ required: [],
1791
+ styled: !0
1792
+ },
1793
+ "List.Fields": {
1794
+ description: "A `<dl>` of `List.Field`s, as many to a line as fit at 8rem each.",
1795
+ import: "import List from '@box-kite/react/components/list';",
1796
+ slots: ["default"],
1797
+ events: [],
1798
+ props: {},
1799
+ required: [],
1800
+ styled: !0
1801
+ },
1802
+ "List.Field": {
1803
+ description: "A labelled value: a `<dt>` and a `<dd>` in a `<div>`, which is the one wrapper a `<dl>` allows.",
1804
+ import: "import List from '@box-kite/react/components/list';",
1805
+ slots: ["label", "default"],
1806
+ events: [],
1807
+ props: {},
1808
+ required: [],
1809
+ styled: !0
1810
+ },
1811
+ "List.Group": {
1812
+ description: "A section of the list: its label, then its own `<ul>` of items.",
1813
+ import: "import List from '@box-kite/react/components/list';",
1814
+ slots: ["label", "default"],
1815
+ events: [],
1816
+ props: {
1817
+ level: {
1818
+ type: "number",
1819
+ enum: [
1820
+ 1,
1821
+ 2,
1822
+ 3,
1823
+ 4,
1824
+ 5,
1825
+ 6
1826
+ ],
1827
+ description: "Makes the label a heading of this level, so a screen reader can jump between groups."
1828
+ },
1829
+ sticky: {
1830
+ type: "boolean",
1831
+ description: "Keeps the label at the top of the screen while its items scroll under it, until the next group's pushes it off."
1832
+ }
1833
+ },
1834
+ required: [],
1835
+ styled: !0
1836
+ },
1837
+ "List.Chevron": {
1838
+ description: "The chevron that ends a drill-in item, pointing along the reading order.",
1839
+ import: "import List from '@box-kite/react/components/list';",
1840
+ slots: ["default"],
1841
+ events: [],
1842
+ props: {},
1843
+ required: [],
1844
+ styled: !0
1845
+ },
1846
+ SwipeItem: {
1847
+ description: "A list item that slides aside to show the commands under it — Mail's archive and delete.",
1848
+ import: "import SwipeItem from '@box-kite/react/components/swipeItem';",
1849
+ slots: [
1850
+ "default",
1851
+ "startActions",
1852
+ "endActions"
1853
+ ],
1854
+ events: ["onOpenChange"],
1855
+ props: {
1856
+ fullSwipe: {
1857
+ type: "boolean",
1858
+ description: "A swipe carried most of the way across performs the outermost action instead of stopping at the tray — iOS's archive."
1859
+ },
1860
+ open: {
1861
+ type: "string",
1862
+ enum: ["start", "end"],
1863
+ description: "Which tray is open."
1864
+ },
1865
+ defaultOpen: {
1866
+ type: "string",
1867
+ enum: ["start", "end"],
1868
+ description: "Which tray is open to begin with."
1869
+ },
1870
+ size: {
1871
+ type: "string",
1872
+ enum: [
1873
+ "sm",
1874
+ "md",
1875
+ "lg"
1876
+ ],
1877
+ description: "The item's spacing, as on `List.Item`."
1878
+ },
1879
+ wrap: {
1880
+ type: "boolean",
1881
+ description: "Lets the item's parts wrap onto a second line, as on `List.Item`."
1882
+ },
1883
+ selected: {
1884
+ type: "boolean",
1885
+ description: "Tints the item as chosen, as on `List.Item`."
1886
+ },
1887
+ chevron: {
1888
+ type: "boolean",
1889
+ description: "Ends the item with a chevron, as on `List.Item`."
1890
+ }
1891
+ },
1892
+ required: [],
1893
+ styled: !0
1894
+ },
1895
+ "SwipeItem.Action": {
1896
+ description: "One command in a tray: a label, and an icon over it if there is one.",
1897
+ import: "import SwipeItem from '@box-kite/react/components/swipeItem';",
1898
+ slots: ["default", "icon"],
1899
+ events: ["onClick"],
1900
+ props: { closeOnSelect: {
1901
+ type: "boolean",
1902
+ description: "Whether choosing the action closes the tray."
1903
+ } },
1904
+ required: [],
1905
+ styled: !0
1906
+ },
1907
+ SortableList: {
1908
+ description: "A list put in order by hand — a playlist, the columns of a report, a set of priorities.",
1909
+ import: "import SortableList from '@box-kite/react/components/sortableList';",
1910
+ slots: ["default"],
1911
+ events: ["onOrderChange", "onOrderCommit"],
1912
+ props: { tag: {
1913
+ type: "string",
1914
+ enum: ["ul", "ol"],
1915
+ description: "`ol` when the order means something — steps, a ranking."
1916
+ } },
1917
+ required: [],
1918
+ styled: !0
1919
+ },
1920
+ "SortableList.Item": {
1921
+ description: "One item in the order: a `List.Item` that knows who it is.",
1922
+ import: "import SortableList from '@box-kite/react/components/sortableList';",
1923
+ slots: ["default"],
1924
+ events: [],
1925
+ props: {
1926
+ value: {
1927
+ type: "string",
1928
+ description: "Who the item is in the order `onOrderChange` reports."
1929
+ },
1930
+ label: {
1931
+ type: "string",
1932
+ description: "What the handle and the announcements call the item: \"Move Ada Lovelace\"."
1933
+ },
1934
+ disabled: {
1935
+ type: "boolean",
1936
+ description: "Leaves the item where it is: its handle is disabled."
1937
+ },
1938
+ size: {
1939
+ type: "string",
1940
+ enum: [
1941
+ "sm",
1942
+ "md",
1943
+ "lg"
1944
+ ],
1945
+ description: "The item's spacing."
1946
+ },
1947
+ wrap: {
1948
+ type: "boolean",
1949
+ description: "Lets the item's parts wrap onto a second line when they do not fit, instead of squeezing."
1950
+ },
1951
+ selected: {
1952
+ type: "boolean",
1953
+ description: "Tints the item as chosen."
1954
+ },
1955
+ chevron: {
1956
+ type: "boolean",
1957
+ description: "Ends the item with a chevron: pressing it goes somewhere with more."
1958
+ }
1959
+ },
1960
+ required: ["value"],
1961
+ styled: !0
1962
+ },
1963
+ "SortableList.Handle": {
1964
+ description: "",
1965
+ import: "import SortableList from '@box-kite/react/components/sortableList';",
1966
+ slots: ["default"],
1967
+ events: [],
1968
+ props: {},
1969
+ required: [],
1970
+ styled: !0
1971
+ },
1972
+ VirtualList: {
1973
+ description: "A list too long to render whole — a mailbox, a contact book, a log.",
1974
+ import: "import VirtualList from '@box-kite/react/components/virtualList';",
1975
+ slots: [],
1976
+ events: [
1977
+ "itemKey",
1978
+ "children",
1979
+ "onRangeChange"
1980
+ ],
1981
+ props: {
1982
+ estimateSize: {
1983
+ type: "number",
1984
+ description: "What an item counts as until one has been drawn, in px — then the mean of those drawn."
1985
+ },
1986
+ overscan: {
1987
+ type: "number",
1988
+ description: "Items kept either side of what is on screen, so a fast scroll has something to show."
1989
+ },
1990
+ initialCount: {
1991
+ type: "number",
1992
+ description: "How many items render before anything is measured — on a server, and in the first frame."
1993
+ },
1994
+ tag: {
1995
+ type: "string",
1996
+ enum: ["ul", "ol"],
1997
+ description: "`ol` when the order means something — steps, a ranking."
1998
+ }
1999
+ },
2000
+ required: [],
2001
+ styled: !0
2002
+ },
1618
2003
  Slider: {
1619
2004
  description: "A value chosen by dragging a thumb along a track.",
1620
2005
  import: "import Slider from '@box-kite/react/components/slider';",
@@ -1786,6 +2171,527 @@ var a = i, o = {
1786
2171
  required: [],
1787
2172
  styled: !0
1788
2173
  },
2174
+ DateField: {
2175
+ description: "A date, a time or both, typed one segment at a time — in the order and with the separators the reader's locale writes them, so `19.10.2026` in Moldova and `10/19/2026` in the US with nothing to configure and nothing to parse.",
2176
+ import: "import DateField from '@box-kite/react/components/dateField';",
2177
+ slots: ["label", "end"],
2178
+ events: ["onValueChange", "isDateUnavailable"],
2179
+ props: {
2180
+ type: {
2181
+ type: "string",
2182
+ enum: [
2183
+ "date",
2184
+ "time",
2185
+ "datetime"
2186
+ ],
2187
+ description: "What it edits: a day (`'date'`, default), a time of day (`'time'`), or both (`'datetime'`)."
2188
+ },
2189
+ value: {
2190
+ anyOf: [{ type: "string" }],
2191
+ description: "Controlled value, an ISO string of the field's kind: `2026-10-19`, `14:30:00`, or for a date-time an instant with its offset (`2026-10-19T14:30:00+03:00`), `…Z` in UTC, or a wall clock with `zone=\"none\"`."
2192
+ },
2193
+ defaultValue: {
2194
+ anyOf: [{ type: "string" }],
2195
+ description: "The value it starts with when the field owns its state."
2196
+ },
2197
+ locale: {
2198
+ type: "string",
2199
+ description: "The language the segments are ordered and named in."
2200
+ },
2201
+ hourCycle: {
2202
+ type: "number",
2203
+ enum: [12, 24],
2204
+ description: "A 12- or 24-hour clock."
2205
+ },
2206
+ granularity: {
2207
+ type: "string",
2208
+ enum: ["minute", "second"],
2209
+ description: "Whether a time is edited to the minute (default) or the second."
2210
+ },
2211
+ min: {
2212
+ anyOf: [{ type: "string" }],
2213
+ description: "The earliest value that is valid."
2214
+ },
2215
+ max: {
2216
+ anyOf: [{ type: "string" }],
2217
+ description: "The latest value that is valid."
2218
+ },
2219
+ disabled: {
2220
+ type: "boolean",
2221
+ description: "Not editable and not focusable, and read out as such."
2222
+ },
2223
+ readOnly: {
2224
+ type: "boolean",
2225
+ description: "Focusable and read out, but not editable."
2226
+ },
2227
+ required: {
2228
+ type: "boolean",
2229
+ description: "The form is not valid until it is filled in — the browser's own check, announced and translated for free."
2230
+ },
2231
+ invalid: {
2232
+ type: "boolean",
2233
+ description: "Marks the value invalid whatever the bounds say."
2234
+ },
2235
+ name: {
2236
+ type: "string",
2237
+ description: "What the value posts under in a form: the canonical string, or nothing while empty."
2238
+ },
2239
+ labelledBy: {
2240
+ type: "string",
2241
+ description: "Names the field after an element already on the page, instead of `label`."
2242
+ },
2243
+ describedBy: {
2244
+ type: "string",
2245
+ description: "An element that describes the field — a hint, an error."
2246
+ },
2247
+ placeholderValue: {
2248
+ type: "string",
2249
+ description: "What an empty segment starts from on an arrow key."
2250
+ },
2251
+ disambiguation: {
2252
+ type: "string",
2253
+ enum: [
2254
+ "compatible",
2255
+ "earlier",
2256
+ "later",
2257
+ "reject"
2258
+ ],
2259
+ description: "What a wall-clock time a zone skips or repeats means."
2260
+ },
2261
+ showZone: {
2262
+ type: "boolean",
2263
+ description: "Whether a date-time names its zone after the time."
2264
+ },
2265
+ autoFocus: {
2266
+ type: "boolean",
2267
+ description: "Focus the first segment on mount."
2268
+ },
2269
+ emptyText: {
2270
+ type: "string",
2271
+ description: "What an empty segment is read out as."
2272
+ },
2273
+ tabIndex: {
2274
+ type: "number",
2275
+ description: "Every segment's tab index."
2276
+ }
2277
+ },
2278
+ required: [],
2279
+ styled: !0
2280
+ },
2281
+ Calendar: {
2282
+ description: "A month of days to pick from, on APG's grid keys — one day or, with `mode=\"range\"`, a start and an end.",
2283
+ import: "import Calendar from '@box-kite/react/components/calendar';",
2284
+ slots: ["default"],
2285
+ events: ["isDateUnavailable", "onFocusedDateChange"],
2286
+ props: {
2287
+ min: {
2288
+ anyOf: [{ type: "string" }],
2289
+ description: "The earliest day that can be chosen, `YYYY-MM-DD`."
2290
+ },
2291
+ max: {
2292
+ anyOf: [{ type: "string" }],
2293
+ description: "The latest day that can be chosen."
2294
+ },
2295
+ locale: {
2296
+ type: "string",
2297
+ description: "The language of the month and weekday names, and whose week it is."
2298
+ },
2299
+ firstDayOfWeek: {
2300
+ type: "number",
2301
+ description: "The day the week starts on, 0 for Sunday."
2302
+ },
2303
+ months: {
2304
+ type: "number",
2305
+ enum: [
2306
+ 1,
2307
+ 2,
2308
+ 3
2309
+ ],
2310
+ description: "How many months side by side."
2311
+ },
2312
+ weekNumbers: {
2313
+ type: "boolean",
2314
+ description: "A leading column of ISO week numbers."
2315
+ },
2316
+ showOutsideDays: {
2317
+ type: "boolean",
2318
+ description: "Whether the days that complete the first and last weeks are drawn."
2319
+ },
2320
+ focusedDate: {
2321
+ type: "string",
2322
+ description: "The day the keyboard is on, which decides the month on show."
2323
+ },
2324
+ defaultFocusedDate: {
2325
+ type: "string",
2326
+ description: "Where the keyboard starts when the calendar owns it."
2327
+ },
2328
+ disabled: {
2329
+ type: "boolean",
2330
+ description: "Nothing can be chosen and nothing is focusable."
2331
+ },
2332
+ readOnly: {
2333
+ type: "boolean",
2334
+ description: "Can be read and navigated, but not chosen in."
2335
+ },
2336
+ autoFocus: {
2337
+ type: "boolean",
2338
+ description: "Focus the day the keyboard is on, on mount — what a picker's panel wants."
2339
+ },
2340
+ label: {
2341
+ type: "string",
2342
+ description: "The calendar's accessible name, which a screen reader hears before the month."
2343
+ },
2344
+ previousLabel: {
2345
+ type: "string",
2346
+ description: "The previous-page button's name."
2347
+ },
2348
+ nextLabel: {
2349
+ type: "string",
2350
+ description: "The next-page button's name."
2351
+ }
2352
+ },
2353
+ required: [],
2354
+ styled: !0
2355
+ },
2356
+ DatePicker: {
2357
+ description: "A field with a calendar, a list of times, or both, behind a button inside it — type the value or pick it.",
2358
+ import: "import DatePicker from '@box-kite/react/components/datePicker';",
2359
+ slots: ["label"],
2360
+ events: [
2361
+ "onValueChange",
2362
+ "isDateUnavailable",
2363
+ "onOpenChange"
2364
+ ],
2365
+ props: {
2366
+ type: {
2367
+ type: "string",
2368
+ enum: [
2369
+ "date",
2370
+ "time",
2371
+ "datetime"
2372
+ ],
2373
+ description: "A day (`'date'`, default), a time of day (`'time'`), or both (`'datetime'`)."
2374
+ },
2375
+ value: {
2376
+ anyOf: [{ type: "string" }],
2377
+ description: "Controlled value, an ISO string of the picker's kind — see `DateField`."
2378
+ },
2379
+ defaultValue: {
2380
+ anyOf: [{ type: "string" }],
2381
+ description: "The value it starts with when the picker owns its state."
2382
+ },
2383
+ hourCycle: {
2384
+ type: "number",
2385
+ enum: [12, 24],
2386
+ description: "A 12- or 24-hour clock, in the field and the list of times."
2387
+ },
2388
+ granularity: {
2389
+ type: "string",
2390
+ enum: ["minute", "second"],
2391
+ description: "Whether a time is edited to the minute (default) or the second."
2392
+ },
2393
+ disambiguation: {
2394
+ type: "string",
2395
+ enum: [
2396
+ "compatible",
2397
+ "earlier",
2398
+ "later",
2399
+ "reject"
2400
+ ],
2401
+ description: "What a wall-clock time a zone skips or repeats means."
2402
+ },
2403
+ name: {
2404
+ type: "string",
2405
+ description: "What the value posts under in a form."
2406
+ },
2407
+ step: {
2408
+ type: "number",
2409
+ description: "Minutes between the times the list offers."
2410
+ },
2411
+ defaultTime: {
2412
+ type: "string",
2413
+ description: "The time a day picked before any time takes."
2414
+ },
2415
+ showZone: {
2416
+ type: "boolean",
2417
+ description: "Whether a date-time names its zone after the time."
2418
+ },
2419
+ locale: {
2420
+ type: "string",
2421
+ description: "The language of the field, the calendar and the times."
2422
+ },
2423
+ min: {
2424
+ anyOf: [{ type: "string" }],
2425
+ description: "The earliest value that is valid, and the first day the calendar offers."
2426
+ },
2427
+ max: {
2428
+ anyOf: [{ type: "string" }],
2429
+ description: "The latest."
2430
+ },
2431
+ disabled: {
2432
+ type: "boolean",
2433
+ description: "Not editable, not focusable and not openable."
2434
+ },
2435
+ readOnly: {
2436
+ type: "boolean",
2437
+ description: "Focusable and read out, but not editable, and the button does not open."
2438
+ },
2439
+ required: {
2440
+ type: "boolean",
2441
+ description: "The form is not valid until it is filled in — the browser's own check."
2442
+ },
2443
+ invalid: {
2444
+ type: "boolean",
2445
+ description: "Marks the value invalid whatever the bounds say."
2446
+ },
2447
+ labelledBy: {
2448
+ type: "string",
2449
+ description: "Names the field after an element already on the page, instead of `label`."
2450
+ },
2451
+ describedBy: {
2452
+ type: "string",
2453
+ description: "An element that describes the field — a hint, an error."
2454
+ },
2455
+ open: {
2456
+ type: "boolean",
2457
+ description: "Whether the panel is open."
2458
+ },
2459
+ defaultOpen: {
2460
+ type: "boolean",
2461
+ description: "Whether it starts open, when the picker owns that itself."
2462
+ },
2463
+ closeOnSelect: {
2464
+ type: "boolean",
2465
+ description: "Whether choosing closes the panel."
2466
+ },
2467
+ firstDayOfWeek: {
2468
+ type: "number",
2469
+ description: "The day the week starts on, 0 for Sunday."
2470
+ },
2471
+ weekNumbers: {
2472
+ type: "boolean",
2473
+ description: "ISO week numbers down the calendar's side."
2474
+ },
2475
+ side: {
2476
+ type: "string",
2477
+ enum: [
2478
+ "top",
2479
+ "bottom",
2480
+ "start",
2481
+ "end"
2482
+ ],
2483
+ description: "Which side of the field the panel opens on."
2484
+ },
2485
+ align: {
2486
+ type: "string",
2487
+ enum: [
2488
+ "start",
2489
+ "center",
2490
+ "end"
2491
+ ],
2492
+ description: "Which of the field's edges it lines up with."
2493
+ },
2494
+ clearable: {
2495
+ type: "boolean",
2496
+ description: "A button inside the field that empties it."
2497
+ },
2498
+ triggerLabel: {
2499
+ type: "string",
2500
+ description: "The calendar button's name."
2501
+ },
2502
+ clearLabel: {
2503
+ type: "string",
2504
+ description: "The clear button's name."
2505
+ },
2506
+ tabIndex: {
2507
+ type: "number",
2508
+ description: "Every segment's and button's tab index."
2509
+ }
2510
+ },
2511
+ required: [],
2512
+ styled: !0
2513
+ },
2514
+ DateRangePicker: {
2515
+ description: "Two dates that make a span — a stay, a reporting period — typed into two fields or picked on a range calendar.",
2516
+ import: "import { DateRangePicker } from '@box-kite/react/components/datePicker';",
2517
+ slots: ["label"],
2518
+ events: [
2519
+ "onValueChange",
2520
+ "isDateUnavailable",
2521
+ "onOpenChange"
2522
+ ],
2523
+ props: {
2524
+ startName: {
2525
+ type: "string",
2526
+ description: "What the start posts under in a form."
2527
+ },
2528
+ endName: {
2529
+ type: "string",
2530
+ description: "What the end posts under."
2531
+ },
2532
+ startLabel: {
2533
+ type: "string",
2534
+ description: "The names a screen reader gives the two fields."
2535
+ },
2536
+ endLabel: {
2537
+ type: "string",
2538
+ description: "The end field's name."
2539
+ },
2540
+ months: {
2541
+ type: "number",
2542
+ enum: [
2543
+ 1,
2544
+ 2,
2545
+ 3
2546
+ ],
2547
+ description: "Months side by side in the panel."
2548
+ },
2549
+ locale: {
2550
+ type: "string",
2551
+ description: "The language of the field, the calendar and the times."
2552
+ },
2553
+ min: {
2554
+ anyOf: [{ type: "string" }],
2555
+ description: "The earliest value that is valid, and the first day the calendar offers."
2556
+ },
2557
+ max: {
2558
+ anyOf: [{ type: "string" }],
2559
+ description: "The latest."
2560
+ },
2561
+ disabled: {
2562
+ type: "boolean",
2563
+ description: "Not editable, not focusable and not openable."
2564
+ },
2565
+ readOnly: {
2566
+ type: "boolean",
2567
+ description: "Focusable and read out, but not editable, and the button does not open."
2568
+ },
2569
+ required: {
2570
+ type: "boolean",
2571
+ description: "The form is not valid until it is filled in — the browser's own check."
2572
+ },
2573
+ invalid: {
2574
+ type: "boolean",
2575
+ description: "Marks the value invalid whatever the bounds say."
2576
+ },
2577
+ labelledBy: {
2578
+ type: "string",
2579
+ description: "Names the field after an element already on the page, instead of `label`."
2580
+ },
2581
+ describedBy: {
2582
+ type: "string",
2583
+ description: "An element that describes the field — a hint, an error."
2584
+ },
2585
+ open: {
2586
+ type: "boolean",
2587
+ description: "Whether the panel is open."
2588
+ },
2589
+ defaultOpen: {
2590
+ type: "boolean",
2591
+ description: "Whether it starts open, when the picker owns that itself."
2592
+ },
2593
+ closeOnSelect: {
2594
+ type: "boolean",
2595
+ description: "Whether choosing closes the panel."
2596
+ },
2597
+ firstDayOfWeek: {
2598
+ type: "number",
2599
+ description: "The day the week starts on, 0 for Sunday."
2600
+ },
2601
+ weekNumbers: {
2602
+ type: "boolean",
2603
+ description: "ISO week numbers down the calendar's side."
2604
+ },
2605
+ side: {
2606
+ type: "string",
2607
+ enum: [
2608
+ "top",
2609
+ "bottom",
2610
+ "start",
2611
+ "end"
2612
+ ],
2613
+ description: "Which side of the field the panel opens on."
2614
+ },
2615
+ align: {
2616
+ type: "string",
2617
+ enum: [
2618
+ "start",
2619
+ "center",
2620
+ "end"
2621
+ ],
2622
+ description: "Which of the field's edges it lines up with."
2623
+ },
2624
+ clearable: {
2625
+ type: "boolean",
2626
+ description: "A button inside the field that empties it."
2627
+ },
2628
+ triggerLabel: {
2629
+ type: "string",
2630
+ description: "The calendar button's name."
2631
+ },
2632
+ clearLabel: {
2633
+ type: "string",
2634
+ description: "The clear button's name."
2635
+ },
2636
+ tabIndex: {
2637
+ type: "number",
2638
+ description: "Every segment's and button's tab index."
2639
+ }
2640
+ },
2641
+ required: [],
2642
+ styled: !0
2643
+ },
2644
+ TimeZoneSelect: {
2645
+ description: "Picks a time zone by place, region or offset — `chis`, `europe` and `+3` all find Chisinau — out of every zone the runtime knows, each with the offset it is at now.",
2646
+ import: "import TimeZoneSelect from '@box-kite/react/components/timeZoneSelect';",
2647
+ slots: ["label", "emptyText"],
2648
+ events: ["onValueChange"],
2649
+ props: {
2650
+ value: {
2651
+ anyOf: [{ type: "string" }],
2652
+ description: "The chosen IANA zone (`Europe/Chisinau`, `UTC`), or `null`."
2653
+ },
2654
+ defaultValue: {
2655
+ anyOf: [{ type: "string" }],
2656
+ description: "The zone it starts with when it owns its state."
2657
+ },
2658
+ zones: {
2659
+ type: "array",
2660
+ items: { type: "string" },
2661
+ description: "Only these zones, in IANA names."
2662
+ },
2663
+ placeholder: {
2664
+ type: "string",
2665
+ description: "The field's placeholder."
2666
+ },
2667
+ name: {
2668
+ type: "string",
2669
+ description: "What the zone posts under in a form."
2670
+ },
2671
+ disabled: {
2672
+ type: "boolean",
2673
+ description: "Not editable and not openable, but still read out."
2674
+ },
2675
+ props: {
2676
+ type: "object",
2677
+ description: "Attributes for the `<input>` itself — an `aria-label`, an `id`."
2678
+ }
2679
+ },
2680
+ required: [],
2681
+ styled: !0
2682
+ },
2683
+ DateTime: {
2684
+ description: "A date or a time, written for whoever is reading: in their language and on their wall clock, inside a real `<time datetime>` that keeps the exact value for a machine.",
2685
+ import: "import DateTime from '@box-kite/react/components/dateTime';",
2686
+ slots: ["default"],
2687
+ events: [],
2688
+ props: { locale: {
2689
+ type: "string",
2690
+ description: "The reader's language."
2691
+ } },
2692
+ required: [],
2693
+ styled: !0
2694
+ },
1789
2695
  Combobox: {
1790
2696
  description: "The APG editable combobox over a list of your own rows: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/",
1791
2697
  import: "import Combobox from '@box-kite/react/components/combobox';",