@cloudflare/kumo 2.11.0 → 2.13.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 (89) hide show
  1. package/CHANGELOG.md +99 -0
  2. package/ai/component-registry.json +147 -278
  3. package/ai/component-registry.md +193 -111
  4. package/ai/schemas.ts +17 -3
  5. package/dist/.build-complete +1 -1
  6. package/dist/ai/schemas.d.ts +62 -0
  7. package/dist/ai/schemas.js +32 -0
  8. package/dist/chunks/{ToolbarInput-gxep3ixoe8r6v2to.js → ToolbarInput-er5t9irqvuwcjrir.js} +28 -1
  9. package/dist/chunks/{autocomplete-o55qql22kc47sjlw.js → autocomplete-msex8kc8sw3fp373.js} +2 -2
  10. package/dist/chunks/{banner-eq9kh1g8b9oyi6hq.js → banner-nz02b60ech1e2m6f.js} +1 -1
  11. package/dist/chunks/{breadcrumbs-kgasqdmjbg8y681l.js → breadcrumbs-jvlyp3bw0u8qx4fi.js} +1 -1
  12. package/dist/chunks/{button-hxznqqdd77atsof9.js → button-iqaz1uluabeo18f0.js} +1 -1
  13. package/dist/chunks/{chart-ic080rf74tgjrgyk.js → chart-qmls2klknm1pd6hs.js} +1 -1
  14. package/dist/chunks/{checkbox-bh2l73lmhuj6pshe.js → checkbox-crxoyqsxiupt9kmi.js} +1 -1
  15. package/dist/chunks/{clipboard-text-gidf1di12egsm2ik.js → clipboard-text-osbgah3jz16ma2vv.js} +4 -4
  16. package/dist/chunks/{collapsible-iztmqjgwv877bx6n.js → collapsible-jyajpe40jcca357s.js} +1 -1
  17. package/dist/chunks/{combobox-lsb1ow9xp8x1rdjk.js → combobox-fktl12ss7vfjryga.js} +3 -3
  18. package/dist/chunks/{dialog-nas75qs6d8gj5dxm.js → dialog-o0164pgcyc74lvp9.js} +1 -1
  19. package/dist/chunks/{empty-m9dbasp44rt37k5y.js → empty-kfofsb6khrn1s26v.js} +1 -1
  20. package/dist/chunks/{field-n2gxrne3rms27myo.js → field-i7lxgmtio7nutt7c.js} +1 -1
  21. package/dist/chunks/{index2.parts-epkfat8l4pvwpd1a.js → index2.parts-kiwz8e3k8utvm4zb.js} +1 -29
  22. package/dist/chunks/{input-group-guisk75j53d1uu5i.js → input-group-ijrmolg1svgq4ayn.js} +5 -5
  23. package/dist/chunks/{input-lmu1aox2ng66bkbr.js → input-jthoux2vfxltqtdh.js} +1 -1
  24. package/dist/chunks/{input-mgdv0d1bgdbaysob.js → input-oc9u4galsdrwy00s.js} +2 -2
  25. package/dist/chunks/{label-jgamnajeg6rm1yz1.js → label-ow6ait7o31g1umgy.js} +2 -2
  26. package/dist/chunks/{menubar-nbjb2uvnryypqjq3.js → menubar-fu5u76o529yi19kp.js} +3 -1
  27. package/dist/chunks/{pagination-oe76uhkp5m9zscrh.js → pagination-crizrd9w23nyw7zq.js} +13 -9
  28. package/dist/chunks/{popover-paah5lvqh1juhfcd.js → popover-jal8z9sv176703lf.js} +3 -3
  29. package/dist/chunks/{select-ipshr3kdgcnjnmyj.js → select-k4olzuzdl8an5gez.js} +27 -12
  30. package/dist/chunks/{sensitive-input-n12o9f5nq4hs9taw.js → sensitive-input-lba9qvv3ai4xwgux.js} +2 -2
  31. package/dist/chunks/{sidebar-ky36geri6bjucsgn.js → sidebar-enm5suo7wq163iw5.js} +106 -48
  32. package/dist/chunks/{switch-entfc87rkpmxuzk0.js → switch-bstb0wl1bi8hjt4z.js} +1 -1
  33. package/dist/chunks/{table-pcdrtuyq1b11t7nr.js → table-hhq2akb92vd5e1x6.js} +2 -2
  34. package/dist/chunks/{text-g96suuboob3eum1a.js → text-jzp4mdlr222iuzxt.js} +33 -16
  35. package/dist/chunks/{toast-c068v3bvvpjn5s4d.js → toast-byzrdv104awqbkjh.js} +2 -2
  36. package/dist/chunks/{toolbar-c3pgxrsuq041bkgt.js → toolbar-jcocktiw68xtixzj.js} +24 -4
  37. package/dist/chunks/{tooltip-fjmcl6d0rrc7ssgu.js → tooltip-k9f7io0k22k5jorq.js} +3 -3
  38. package/dist/code.js +1 -1
  39. package/dist/components/autocomplete.js +1 -1
  40. package/dist/components/banner.js +1 -1
  41. package/dist/components/breadcrumbs.js +1 -1
  42. package/dist/components/button.js +1 -1
  43. package/dist/components/chart.js +1 -1
  44. package/dist/components/checkbox.js +1 -1
  45. package/dist/components/clipboard-text.js +1 -1
  46. package/dist/components/collapsible.js +1 -1
  47. package/dist/components/combobox.js +1 -1
  48. package/dist/components/dialog.js +1 -1
  49. package/dist/components/empty.js +1 -1
  50. package/dist/components/field.js +1 -1
  51. package/dist/components/input-group.js +1 -1
  52. package/dist/components/input.js +3 -3
  53. package/dist/components/label.js +1 -1
  54. package/dist/components/menubar.d.ts +1 -1
  55. package/dist/components/menubar.js +1 -1
  56. package/dist/components/pagination.d.ts +1 -1
  57. package/dist/components/pagination.js +1 -1
  58. package/dist/components/popover.js +1 -1
  59. package/dist/components/select.d.ts +1 -1
  60. package/dist/components/select.js +1 -1
  61. package/dist/components/sensitive-input.js +1 -1
  62. package/dist/components/sidebar.d.ts +2 -2
  63. package/dist/components/sidebar.js +1 -1
  64. package/dist/components/switch.js +1 -1
  65. package/dist/components/table.d.ts +1 -1
  66. package/dist/components/table.js +1 -1
  67. package/dist/components/text.d.ts +1 -1
  68. package/dist/components/text.js +1 -1
  69. package/dist/components/toast.js +1 -1
  70. package/dist/components/toolbar.d.ts +2 -2
  71. package/dist/components/toolbar.js +1 -1
  72. package/dist/components/tooltip.js +1 -1
  73. package/dist/{index-DCA5tjHa.d.ts → index-B7epkoHc.d.ts} +4 -0
  74. package/dist/{index-DTjmw8Vy2.d.ts → index-BXsHCLB82.d.ts} +4 -2
  75. package/dist/{index-DpzpArsi2.d.ts → index-CMiftS8L2.d.ts} +45 -3
  76. package/dist/{index-CaoLMX-b2.d.ts → index-D97n4Bpf2.d.ts} +4 -2
  77. package/dist/{index-Dsn2VLZv.d.ts → index-DYYiDxZs.d.ts} +5 -0
  78. package/dist/index-Dh95FgdH2.d.ts +60 -0
  79. package/dist/{index-BkyMHk632.d.ts → index-Dzzi1o7w2.d.ts} +30 -16
  80. package/dist/{index-BHclAeEt2.d.ts → index-_Sl5wohy2.d.ts} +1 -1
  81. package/dist/index.d.ts +8 -8
  82. package/dist/index.js +28 -28
  83. package/dist/primitives/toolbar.js +1 -1
  84. package/dist/primitives.js +1 -1
  85. package/dist/scripts/theme-generator/config.js +6 -4
  86. package/dist/styles/kumo-standalone.css +1 -1
  87. package/dist/styles/theme-kumo.css +7 -10
  88. package/package.json +1 -1
  89. package/scripts/theme-generator/config.ts +8 -4
@@ -1639,7 +1639,7 @@ Read-only text field with a one-click copy-to-clipboard button.
1639
1639
 
1640
1640
  **Colors (kumo tokens used):**
1641
1641
 
1642
- `bg-kumo-base`, `border-kumo-line`, `outline-kumo-fill`, `ring-kumo-brand`, `ring-kumo-focus`, `text-kumo-default`
1642
+ `bg-kumo-base`, `border-kumo-line`, `outline-kumo-line`, `ring-kumo-brand`, `ring-kumo-focus`, `text-kumo-default`
1643
1643
 
1644
1644
  **Styling:**
1645
1645
 
@@ -2188,7 +2188,7 @@ Collapsible — a composable disclosure component for showing/hiding content.
2188
2188
 
2189
2189
  **Colors (kumo tokens used):**
2190
2190
 
2191
- `border-kumo-fill`, `text-kumo-link`
2191
+ `border-kumo-fill`, `text-kumo-default`
2192
2192
 
2193
2193
  **Sub-Components:**
2194
2194
 
@@ -5547,30 +5547,6 @@ MenuBar — horizontal icon-button toolbar with keyboard arrow-key navigation.
5547
5547
  **Styling:**
5548
5548
 
5549
5549
 
5550
- **Examples:**
5551
-
5552
- ```tsx
5553
- <MenuBar
5554
- isActive={active}
5555
- optionIds
5556
- options={[
5557
- {
5558
- icon: <TextBolderIcon />,
5559
- id: "bold",
5560
- tooltip: "Bold",
5561
- onClick: () => setActive(active === "bold" ? undefined : "bold"),
5562
- },
5563
- {
5564
- icon: <TextItalicIcon />,
5565
- id: "italic",
5566
- tooltip: "Italic",
5567
- onClick: () => setActive(active === "italic" ? undefined : "italic"),
5568
- },
5569
- ]}
5570
- />
5571
- ```
5572
-
5573
-
5574
5550
  ---
5575
5551
 
5576
5552
  ### Meter
@@ -5651,6 +5627,8 @@ Pagination component
5651
5627
  Number of items displayed per page.
5652
5628
  - `totalCount`: number
5653
5629
  Total number of items across all pages.
5630
+ - `hasNextPage`: boolean
5631
+ Whether another page exists when the total count is unknown. Ignored when `totalCount` is provided. Unknown totals use sequential controls only.
5654
5632
  - `className`: string
5655
5633
  Additional CSS classes for the container
5656
5634
  - `labels`: PaginationLabels
@@ -5732,6 +5710,15 @@ Props:
5732
5710
  />
5733
5711
  ```
5734
5712
 
5713
+ ```tsx
5714
+ <Pagination
5715
+ text={() => `Page ${page}`}
5716
+ page={page}
5717
+ setPage={setPage}
5718
+ hasNextPage={hasNextPage}
5719
+ />
5720
+ ```
5721
+
5735
5722
  ```tsx
5736
5723
  <Pagination
5737
5724
  text={({ perPage }: { perPage?: number }) =>
@@ -5878,7 +5865,7 @@ Popover component for displaying accessible popup content anchored to a trigger.
5878
5865
 
5879
5866
  **Colors (kumo tokens used):**
5880
5867
 
5881
- `bg-kumo-base`, `fill-kumo-base`, `fill-kumo-tip-shadow`, `fill-kumo-tip-stroke`, `outline-kumo-fill`, `text-kumo-default`, `text-kumo-subtle`
5868
+ `bg-kumo-base`, `fill-kumo-arrow-edge`, `fill-kumo-arrow-stroke`, `fill-kumo-base`, `outline-kumo-line`, `text-kumo-default`, `text-kumo-subtle`
5882
5869
 
5883
5870
  **Sub-Components:**
5884
5871
 
@@ -6655,6 +6642,63 @@ Select component
6655
6642
 
6656
6643
  **Props:**
6657
6644
 
6645
+ - `align`: enum
6646
+ How to align the popup relative to the specified side.
6647
+ - `alignItemWithTrigger`: boolean
6648
+ Whether the positioner overlaps the trigger so the selected item's text is aligned with the trigger's value text. This only applies to mouse input and is automatically disabled if there is not enough space.
6649
+ - `alignOffset`: number | OffsetFunction
6650
+ Additional offset along the alignment axis in pixels. Also accepts a function that returns the offset to read the dimensions of the anchor and positioner elements, along with its side and alignment.
6651
+
6652
+ The function takes a `data` object parameter with the following properties:
6653
+ - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
6654
+ - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
6655
+ - `data.side`: which side of the anchor element the positioner is aligned against.
6656
+ - `data.align`: how the positioner is aligned relative to the specified side.
6657
+ - `anchor`: ReactNode
6658
+ An element to position the popup against. By default, the popup will be positioned against the trigger.
6659
+ - `arrowPadding`: number
6660
+ Minimum distance to maintain between the arrow and the edges of the popup.
6661
+
6662
+ Use it to prevent the arrow element from hanging out of the rounded corners of a popup.
6663
+ - `collisionAvoidance`: CollisionAvoidance
6664
+ Determines how to handle collisions when positioning the popup.
6665
+
6666
+ `side` controls overflow on the preferred placement axis (`top`/`bottom` or `left`/`right`):
6667
+ - `'flip'`: keep the requested side when it fits; otherwise try the opposite side (`top` and `bottom`, or `left` and `right`).
6668
+ - `'shift'`: never change side; keep the requested side and move the popup within the clipping boundary so it stays visible.
6669
+ - `'none'`: do not correct side-axis overflow.
6670
+
6671
+ `align` controls overflow on the alignment axis (`start`/`center`/`end`):
6672
+ - `'flip'`: keep side, but swap `start` and `end` when the requested alignment overflows.
6673
+ - `'shift'`: keep side and requested alignment, then nudge the popup along the alignment axis to fit.
6674
+ - `'none'`: do not correct alignment-axis overflow.
6675
+
6676
+ `fallbackAxisSide` controls fallback behavior on the perpendicular axis when the preferred axis cannot fit:
6677
+ - `'start'`: allow perpendicular fallback and try the logical start side first (`top` before `bottom`, or `left` before `right` in LTR).
6678
+ - `'end'`: allow perpendicular fallback and try the logical end side first (`bottom` before `top`, or `right` before `left` in LTR).
6679
+ - `'none'`: do not fallback to the perpendicular axis.
6680
+
6681
+ When `side` is `'shift'`, explicitly setting `align` only supports `'shift'` or `'none'`. If `align` is omitted, it defaults to `'flip'`.
6682
+ - `collisionBoundary`: Boundary
6683
+ An element or a rectangle that delimits the area that the popup is confined to.
6684
+ - `collisionPadding`: Padding
6685
+ Additional space to maintain from the edge of the collision boundary.
6686
+ - `disableAnchorTracking`: boolean
6687
+ Whether to disable the popup from tracking any layout shift of its positioning anchor.
6688
+ - `positionMethod`: enum
6689
+ Determines which CSS `position` property to use.
6690
+ - `side`: enum
6691
+ Which side of the anchor element to align the popup against. May automatically change to avoid collisions.
6692
+ - `sideOffset`: number | OffsetFunction
6693
+ Distance between the anchor and the popup in pixels. Also accepts a function that returns the distance to read the dimensions of the anchor and positioner elements, along with its side and alignment.
6694
+
6695
+ The function takes a `data` object parameter with the following properties:
6696
+ - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
6697
+ - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
6698
+ - `data.side`: which side of the anchor element the positioner is aligned against.
6699
+ - `data.align`: how the positioner is aligned relative to the specified side.
6700
+ - `sticky`: boolean
6701
+ Whether to maintain the popup in the viewport after the anchor element was scrolled out of view.
6658
6702
  - `className`: string
6659
6703
  Additional CSS classes merged via `cn()`.
6660
6704
  - `render`: ReactNode
@@ -6695,7 +6739,7 @@ Select component
6695
6739
 
6696
6740
  **Colors (kumo tokens used):**
6697
6741
 
6698
- `bg-kumo-base`, `bg-kumo-elevated`, `bg-kumo-hairline`, `bg-kumo-tint`, `border-kumo-line`, `ring-kumo-brand`, `ring-kumo-danger`, `ring-kumo-focus`, `ring-kumo-line`, `text-kumo-danger`, `text-kumo-default`, `text-kumo-placeholder`, `text-kumo-subtle`
6742
+ `bg-kumo-base`, `bg-kumo-control`, `bg-kumo-hairline`, `bg-kumo-tint`, `border-kumo-line`, `ring-kumo-brand`, `ring-kumo-danger`, `ring-kumo-focus`, `ring-kumo-line`, `text-kumo-danger`, `text-kumo-default`, `text-kumo-placeholder`, `text-kumo-subtle`
6699
6743
 
6700
6744
  **Styling:**
6701
6745
 
@@ -7039,6 +7083,58 @@ Separator sub-component
7039
7083
  </Select>
7040
7084
  ```
7041
7085
 
7086
+ ```tsx
7087
+ <div className="grid gap-4 sm:grid-cols-2">
7088
+ <Select
7089
+ label="side=bottom (default)"
7090
+ className="w-[200px]"
7091
+ defaultValue="earth"
7092
+ items={planets}
7093
+ />
7094
+ <Select
7095
+ label="side=top"
7096
+ side="top"
7097
+ className="w-[200px]"
7098
+ defaultValue="earth"
7099
+ items={planets}
7100
+ />
7101
+ <Select
7102
+ label="align=end"
7103
+ align="end"
7104
+ className="w-[200px]"
7105
+ defaultValue="earth"
7106
+ items={planets}
7107
+ />
7108
+ <Select
7109
+ label="sideOffset=12"
7110
+ sideOffset={12}
7111
+ className="w-[200px]"
7112
+ defaultValue="earth"
7113
+ items={planets}
7114
+ />
7115
+ </div>
7116
+ ```
7117
+
7118
+ ```tsx
7119
+ <div className="flex flex-wrap items-start gap-8">
7120
+ <Select
7121
+ label="Anchored (default)"
7122
+ description="Opens below the trigger"
7123
+ className="w-[200px]"
7124
+ defaultValue="mars"
7125
+ items={planets}
7126
+ />
7127
+ <Select
7128
+ label="Aligned to selection"
7129
+ description="Selected option lands on the trigger"
7130
+ alignItemWithTrigger
7131
+ className="w-[200px]"
7132
+ defaultValue="mars"
7133
+ items={planets}
7134
+ />
7135
+ </div>
7136
+ ```
7137
+
7042
7138
 
7043
7139
  ---
7044
7140
 
@@ -7253,112 +7349,56 @@ Props:
7253
7349
  Header sub-component
7254
7350
 
7255
7351
  Props:
7256
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7257
- - `active`: boolean
7258
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7259
- - `href`: string
7260
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7261
- - `tooltip`: string
7262
- - `className`: string
7263
- - `children`: ReactNode
7352
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7264
7353
 
7265
7354
  #### Sidebar.Content
7266
7355
 
7267
7356
  Content sub-component
7268
7357
 
7269
7358
  Props:
7270
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7271
- - `active`: boolean
7272
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7273
- - `href`: string
7274
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7275
- - `tooltip`: string
7276
- - `className`: string
7277
- - `children`: ReactNode
7359
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7278
7360
 
7279
7361
  #### Sidebar.Footer
7280
7362
 
7281
7363
  Footer sub-component
7282
7364
 
7283
7365
  Props:
7284
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7285
- - `active`: boolean
7286
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7287
- - `href`: string
7288
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7289
- - `tooltip`: string
7290
- - `className`: string
7291
- - `children`: ReactNode
7366
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7292
7367
 
7293
7368
  #### Sidebar.Loading
7294
7369
 
7295
7370
  Loading sub-component
7296
7371
 
7297
7372
  Props:
7298
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7299
- - `active`: boolean
7300
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7301
- - `href`: string
7302
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7303
- - `tooltip`: string
7304
- - `className`: string
7305
- - `children`: ReactNode
7373
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7306
7374
 
7307
7375
  #### Sidebar.Group
7308
7376
 
7309
7377
  Group sub-component
7310
7378
 
7311
7379
  Props:
7312
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7313
- - `active`: boolean
7314
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7315
- - `href`: string
7316
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7317
- - `tooltip`: string
7318
- - `className`: string
7319
- - `children`: ReactNode
7380
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7320
7381
 
7321
7382
  #### Sidebar.GroupLabel
7322
7383
 
7323
7384
  GroupLabel sub-component
7324
7385
 
7325
7386
  Props:
7326
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7327
- - `active`: boolean
7328
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7329
- - `href`: string
7330
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7331
- - `tooltip`: string
7332
- - `className`: string
7333
- - `children`: ReactNode
7387
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7334
7388
 
7335
7389
  #### Sidebar.Menu
7336
7390
 
7337
7391
  Menu sub-component
7338
7392
 
7339
7393
  Props:
7340
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7341
- - `active`: boolean
7342
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7343
- - `href`: string
7344
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7345
- - `tooltip`: string
7346
- - `className`: string
7347
- - `children`: ReactNode
7394
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7348
7395
 
7349
7396
  #### Sidebar.MenuItem
7350
7397
 
7351
7398
  MenuItem sub-component
7352
7399
 
7353
7400
  Props:
7354
- - `icon`: React.ComponentType<{ className?: string }> | React.ReactNode
7355
- - `active`: boolean
7356
- - `size`: SidebarMenuButtonSize - Button size. - `"base"` — Standard nav item - `"sm"` — Compact nav item
7357
- - `href`: string
7358
- - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7359
- - `tooltip`: string
7360
- - `className`: string
7361
- - `children`: ReactNode
7401
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7362
7402
 
7363
7403
  #### Sidebar.MenuButton
7364
7404
 
@@ -7371,6 +7411,7 @@ Props:
7371
7411
  - `href`: string
7372
7412
  - `target`: React.HTMLAttributeAnchorTarget - Link target — only meaningful when `href` is provided.
7373
7413
  - `tooltip`: string
7414
+ - `itemId`: string - Anchor id for `useSidebar().scrollToItem(id)`.
7374
7415
  - `className`: string
7375
7416
  - `children`: ReactNode
7376
7417
 
@@ -8067,6 +8108,40 @@ Props:
8067
8108
  </DemoContainer>
8068
8109
  ```
8069
8110
 
8111
+ ```tsx
8112
+ <DemoContainer>
8113
+ <Sidebar.Provider contained defaultOpen className="h-full min-h-0!">
8114
+ <Sidebar>
8115
+ <Sidebar.Header>
8116
+ <BrandLogo />
8117
+ </Sidebar.Header>
8118
+ <Sidebar.Content>
8119
+ <Sidebar.Group>
8120
+ <Sidebar.Menu>
8121
+ {LONG_NAV_ITEMS.map((label, idx) => (
8122
+ <Sidebar.MenuButton
8123
+ key={label}
8124
+ icon={idx === 0 ? HouseIcon : GlobeIcon}
8125
+ active={idx === 0}
8126
+ itemId={ANCHOR_ID_BY_LABEL[label]}
8127
+ >
8128
+ {label}
8129
+ </Sidebar.MenuButton>
8130
+ ))}
8131
+ </Sidebar.Menu>
8132
+ </Sidebar.Group>
8133
+ </Sidebar.Content>
8134
+ <Sidebar.Footer>
8135
+ <Sidebar.Trigger />
8136
+ </Sidebar.Footer>
8137
+ </Sidebar>
8138
+ <DemoMain>
8139
+ <ScrollToItemControls />
8140
+ </DemoMain>
8141
+ </Sidebar.Provider>
8142
+ </DemoContainer>
8143
+ ```
8144
+
8070
8145
  ```tsx
8071
8146
  <div className="relative h-[540px] w-full overflow-hidden rounded-lg border border-kumo-line bg-kumo-base">
8072
8147
  <Sidebar.Provider contained mobileBreakpoint={9999} className="h-full">
@@ -9289,9 +9364,10 @@ Text component
9289
9364
  **Props:**
9290
9365
 
9291
9366
  - `variant`: enum [default: body]
9292
- - `"heading1"`: Large heading for page titles
9293
- - `"heading2"`: Medium heading for section titles
9294
- - `"heading3"`: Small heading for subsections
9367
+ - `"heading"`: Heading text (16px by default, 20px at large size)
9368
+ - `"heading1"`: Deprecated large heading for page titles; use heading instead
9369
+ - `"heading2"`: Deprecated medium heading for section titles; use heading instead
9370
+ - `"heading3"`: Deprecated small heading for subsections; use heading instead
9295
9371
  - `"body"`: Default body text
9296
9372
  - `"secondary"`: Muted text for secondary information
9297
9373
  - `"success"`: Success state text
@@ -9310,7 +9386,8 @@ Text component
9310
9386
  - `as`: enum
9311
9387
  The HTML element to render. Accepts headings (`"h1"`–`"h6"`), block text (`"p"`, `"pre"`), inline text (`"span"`, `"code"`, `"em"`, `"strong"`, `"small"`, `"abbr"`, `"time"`), form-related (`"label"`, `"legend"`), list/definition (`"dt"`, `"dd"`, `"li"`), and `"figcaption"`.
9312
9388
 
9313
- - **Required** for heading variants (`"heading1"`, `"heading2"`, `"heading3"`) — pick the element that reflects this text's place in the document outline, or `"span"` for decorative heading-styled text that is not a section heading.
9389
+ - **Optional** for `"heading"` (defaults to `"span"`). Pass the heading element that reflects this text's place in the document outline.
9390
+ - **Required** for deprecated heading variants (`"heading1"`, `"heading2"`, `"heading3"`).
9314
9391
  - **Optional** for body variants (defaults to `"p"`) and monospace variants (defaults to `"span"`).
9315
9392
  - `children`: ReactNode
9316
9393
  Text content.
@@ -9327,22 +9404,14 @@ Text component
9327
9404
  ```tsx
9328
9405
  <div className="grid w-full grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3">
9329
9406
  <div className="flex flex-col justify-end gap-1 rounded-lg border border-kumo-hairline bg-kumo-base p-4">
9330
- <Text variant="heading1" as="h1">
9331
- Heading 1
9332
- </Text>
9333
- <Text variant="mono-secondary">text-3xl (30px)</Text>
9334
- </div>
9335
- <div className="flex flex-col justify-end gap-1 rounded-lg border border-kumo-hairline bg-kumo-base p-4">
9336
- <Text variant="heading2" as="h2">
9337
- Heading 2
9338
- </Text>
9339
- <Text variant="mono-secondary">text-2xl (24px)</Text>
9407
+ <Text variant="heading">Heading</Text>
9408
+ <Text variant="mono-secondary">text-lg (16px)</Text>
9340
9409
  </div>
9341
9410
  <div className="flex flex-col justify-end gap-1 rounded-lg border border-kumo-hairline bg-kumo-base p-4">
9342
- <Text variant="heading3" as="h3">
9343
- Heading 3
9411
+ <Text variant="heading" size="lg" as="h2">
9412
+ Heading large
9344
9413
  </Text>
9345
- <Text variant="mono-secondary">text-lg (16px)</Text>
9414
+ <Text variant="mono-secondary">text-xl (20px)</Text>
9346
9415
  </div>
9347
9416
  <div className="flex flex-col justify-end gap-1 rounded-lg border border-kumo-hairline bg-kumo-base p-4">
9348
9417
  <Text>Body</Text>
@@ -9469,7 +9538,7 @@ TimeseriesChart — a time-series line or bar chart.
9469
9538
 
9470
9539
  **Colors (kumo tokens used):**
9471
9540
 
9472
- `bg-kumo-base`, `outline-kumo-fill`
9541
+ `bg-kumo-base`, `outline-kumo-line`
9473
9542
 
9474
9543
  **Examples:**
9475
9544
 
@@ -9954,6 +10023,10 @@ This is a compound component. Use these sub-components:
9954
10023
 
9955
10024
  Button sub-component
9956
10025
 
10026
+ #### Toolbar.Link
10027
+
10028
+ Link sub-component
10029
+
9957
10030
  #### Toolbar.Input
9958
10031
 
9959
10032
  Input sub-component
@@ -10012,6 +10085,15 @@ InputGroup sub-component
10012
10085
  </Toolbar>
10013
10086
  ```
10014
10087
 
10088
+ ```tsx
10089
+ <Toolbar>
10090
+ <Toolbar.Link href="/components/button" icon={BookOpenIcon}>
10091
+ Button documentation
10092
+ </Toolbar.Link>
10093
+ <Toolbar.Button icon={DownloadSimpleIcon}>Download</Toolbar.Button>
10094
+ </Toolbar>
10095
+ ```
10096
+
10015
10097
  ```tsx
10016
10098
  <Toolbar className="w-full max-w-lg">
10017
10099
  <Toolbar.Input
@@ -10089,7 +10171,7 @@ Accessible popup that shows additional information on hover/focus. Wrap your app
10089
10171
 
10090
10172
  **Colors (kumo tokens used):**
10091
10173
 
10092
- `bg-kumo-base`, `fill-kumo-base`, `fill-kumo-tip-shadow`, `fill-kumo-tip-stroke`, `outline-kumo-fill`, `text-kumo-default`
10174
+ `bg-kumo-base`, `fill-kumo-arrow-edge`, `fill-kumo-arrow-stroke`, `fill-kumo-base`, `outline-kumo-line`, `text-kumo-default`
10093
10175
 
10094
10176
  **Sub-Components:**
10095
10177
 
package/ai/schemas.ts CHANGED
@@ -704,6 +704,7 @@ export const PaginationPropsSchema = z.object({
704
704
  page: z.number().optional(), // Current page number (1-indexed).
705
705
  perPage: z.number().optional(), // Number of items displayed per page.
706
706
  totalCount: z.number().optional(), // Total number of items across all pages.
707
+ hasNextPage: z.boolean().optional(), // Whether another page exists when the total count is unknown. Ignored when `totalCount` is provided. Unknown totals use sequential controls only.
707
708
  className: z.string().optional(), // Additional CSS classes for the container
708
709
  labels: z.unknown().optional(), // Labels for internationalization of aria-labels. All labels have English defaults. For visible text like "Showing X of Y", use render props on sub-components: - `Pagination.Info` children for the info text - `Pagination.PageSize` label prop for the "Per page:" text
709
710
  children: z.union([z.string(), z.number(), z.boolean(), z.null(), DynamicValueSchema]).optional(), // Compound component children for custom layouts. Use Pagination.Info, Pagination.PageSize, Pagination.Controls, and Pagination.Separator.
@@ -754,6 +755,19 @@ export const SankeyChartPropsSchema = z.object({
754
755
  });
755
756
 
756
757
  export const SelectPropsSchema = z.object({
758
+ align: z.enum(["start", "center", "end"]).optional(), // How to align the popup relative to the specified side.
759
+ alignItemWithTrigger: z.boolean().optional(), // Whether the positioner overlaps the trigger so the selected item's text is aligned with the trigger's value text. This only applies to mouse input and is automatically disabled if there is not enough space.
760
+ alignOffset: z.unknown().optional(), // Additional offset along the alignment axis in pixels. Also accepts a function that returns the offset to read the dimensions of the anchor and positioner elements, along with its side and alignment. The function takes a `data` object parameter with the following properties: - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`. - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`. - `data.side`: which side of the anchor element the positioner is aligned against. - `data.align`: how the positioner is aligned relative to the specified side.
761
+ anchor: z.union([z.string(), z.number(), z.boolean(), z.null(), DynamicValueSchema]).optional(), // An element to position the popup against. By default, the popup will be positioned against the trigger.
762
+ arrowPadding: z.number().optional(), // Minimum distance to maintain between the arrow and the edges of the popup. Use it to prevent the arrow element from hanging out of the rounded corners of a popup.
763
+ collisionAvoidance: z.unknown().optional(), // Determines how to handle collisions when positioning the popup. `side` controls overflow on the preferred placement axis (`top`/`bottom` or `left`/`right`): - `'flip'`: keep the requested side when it fits; otherwise try the opposite side (`top` and `bottom`, or `left` and `right`). - `'shift'`: never change side; keep the requested side and move the popup within the clipping boundary so it stays visible. - `'none'`: do not correct side-axis overflow. `align` controls overflow on the alignment axis (`start`/`center`/`end`): - `'flip'`: keep side, but swap `start` and `end` when the requested alignment overflows. - `'shift'`: keep side and requested alignment, then nudge the popup along the alignment axis to fit. - `'none'`: do not correct alignment-axis overflow. `fallbackAxisSide` controls fallback behavior on the perpendicular axis when the preferred axis cannot fit: - `'start'`: allow perpendicular fallback and try the logical start side first (`top` before `bottom`, or `left` before `right` in LTR). - `'end'`: allow perpendicular fallback and try the logical end side first (`bottom` before `top`, or `right` before `left` in LTR). - `'none'`: do not fallback to the perpendicular axis. When `side` is `'shift'`, explicitly setting `align` only supports `'shift'` or `'none'`. If `align` is omitted, it defaults to `'flip'`.
764
+ collisionBoundary: z.unknown().optional(), // An element or a rectangle that delimits the area that the popup is confined to.
765
+ collisionPadding: z.unknown().optional(), // Additional space to maintain from the edge of the collision boundary.
766
+ disableAnchorTracking: z.boolean().optional(), // Whether to disable the popup from tracking any layout shift of its positioning anchor.
767
+ positionMethod: z.enum(["absolute", "fixed"]).optional(), // Determines which CSS `position` property to use.
768
+ side: z.enum(["top", "bottom", "left", "right", "inline-end", "inline-start"]).optional(), // Which side of the anchor element to align the popup against. May automatically change to avoid collisions.
769
+ sideOffset: z.unknown().optional(), // Distance between the anchor and the popup in pixels. Also accepts a function that returns the distance to read the dimensions of the anchor and positioner elements, along with its side and alignment. The function takes a `data` object parameter with the following properties: - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`. - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`. - `data.side`: which side of the anchor element the positioner is aligned against. - `data.align`: how the positioner is aligned relative to the specified side.
770
+ sticky: z.boolean().optional(), // Whether to maintain the popup in the viewport after the anchor element was scrolled out of view.
757
771
  className: z.string().optional(), // Additional CSS classes merged via `cn()`.
758
772
  render: z.union([z.string(), z.number(), z.boolean(), z.null(), DynamicValueSchema]).optional(), // Replaces the trigger element while preserving Select behavior.
759
773
  size: z.enum(["xs", "sm", "base", "lg"]).optional(), // Size of the select trigger. Matches Input component sizes.
@@ -880,11 +894,11 @@ export const TabsPropsSchema = z.object({
880
894
  });
881
895
 
882
896
  export const TextPropsSchema = z.object({
883
- variant: z.enum(["heading1", "heading2", "heading3", "body", "secondary", "success", "error", "mono", "mono-secondary"]).optional(), // Text style variant. Determines color, font, and weight. - `"heading1"` — Large page title (30px, semibold) - `"heading2"` — Section title (24px, semibold) - `"heading3"` — Subsection title (18px, semibold) - `"body"` — Default body text - `"secondary"` — Muted text for secondary information - `"success"` — Success state text - `"error"` — Error state text - `"mono"` — Monospace text for code - `"mono-secondary"` — Muted monospace text
884
- size: z.enum(["xs", "sm", "base", "lg"]).optional(), // Text size (only applies to body/secondary/success/error variants). - `"xs"` — 12px - `"sm"` — 14px - `"base"` — 16px - `"lg"` — 18px
897
+ variant: z.enum(["heading", "heading1", "heading2", "heading3", "body", "secondary", "success", "error", "mono", "mono-secondary"]).optional(), // Text style variant. Determines color, font, and weight. - `"heading"` — Heading text (16px by default, 20px with `size="lg"`; semibold) - `"heading1"` — Deprecated; use `"heading"` (30px, semibold) - `"heading2"` — Deprecated; use `"heading"` (24px, semibold) - `"heading3"` — Deprecated; use `"heading"` (16px, semibold) - `"body"` — Default body text - `"secondary"` — Muted text for secondary information - `"success"` — Success state text - `"error"` — Error state text - `"mono"` — Monospace text for code - `"mono-secondary"` — Muted monospace text
898
+ size: z.enum(["xs", "sm", "base", "lg"]).optional(), // Text size. Supported values depend on the variant: - `"heading"` — 16px when omitted, or 20px with `"lg"` - Body variants — `"xs"` (12px), `"sm"` (13px), `"base"` (14px), or `"lg"` (16px) - Monospace variants — 13px when omitted, or 14px with `"lg"`
885
899
  bold: z.boolean().optional(), // Whether to use bold font weight (only applies to body variants).
886
900
  truncate: z.boolean().optional(), // Whether to truncate overflowing text with an ellipsis. Adds `truncate min-w-0` classes.
887
- as: z.enum(["h1", "h2", "h3", "h4", "h5", "h6", "p", "span", "label", "dt", "dd", "li", "figcaption", "legend", "pre", "code", "em", "strong", "small", "abbr", "time"]).optional(), // The HTML element to render. Accepts headings (`"h1"`–`"h6"`), block text (`"p"`, `"pre"`), inline text (`"span"`, `"code"`, `"em"`, `"strong"`, `"small"`, `"abbr"`, `"time"`), form-related (`"label"`, `"legend"`), list/definition (`"dt"`, `"dd"`, `"li"`), and `"figcaption"`. - **Required** for heading variants (`"heading1"`, `"heading2"`, `"heading3"`) — pick the element that reflects this text's place in the document outline, or `"span"` for decorative heading-styled text that is not a section heading. - **Optional** for body variants (defaults to `"p"`) and monospace variants (defaults to `"span"`).
901
+ as: z.enum(["h1", "h2", "h3", "h4", "h5", "h6", "p", "span", "label", "dt", "dd", "li", "figcaption", "legend", "pre", "code", "em", "strong", "small", "abbr", "time"]).optional(), // The HTML element to render. Accepts headings (`"h1"`–`"h6"`), block text (`"p"`, `"pre"`), inline text (`"span"`, `"code"`, `"em"`, `"strong"`, `"small"`, `"abbr"`, `"time"`), form-related (`"label"`, `"legend"`), list/definition (`"dt"`, `"dd"`, `"li"`), and `"figcaption"`. - **Optional** for `"heading"` (defaults to `"span"`). Pass the heading element that reflects this text's place in the document outline. - **Required** for deprecated heading variants (`"heading1"`, `"heading2"`, `"heading3"`). - **Optional** for body variants (defaults to `"p"`) and monospace variants (defaults to `"span"`).
888
902
  children: z.union([z.string(), z.number(), z.boolean(), z.null(), DynamicValueSchema]).optional(), // Text content.
889
903
  });
890
904
 
@@ -1 +1 @@
1
- 1787081382182
1
+ 1788292361227
@@ -966,6 +966,7 @@ declare const PaginationPropsSchema: z.ZodObject<{
966
966
  page: z.ZodOptional<z.ZodNumber>;
967
967
  perPage: z.ZodOptional<z.ZodNumber>;
968
968
  totalCount: z.ZodOptional<z.ZodNumber>;
969
+ hasNextPage: z.ZodOptional<z.ZodBoolean>;
969
970
  className: z.ZodOptional<z.ZodString>;
970
971
  labels: z.ZodOptional<z.ZodUnknown>;
971
972
  children: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
@@ -1029,6 +1030,35 @@ declare const SankeyChartPropsSchema: z.ZodObject<{
1029
1030
  isDarkMode: z.ZodOptional<z.ZodBoolean>;
1030
1031
  }, z.core.$strip>;
1031
1032
  declare const SelectPropsSchema: z.ZodObject<{
1033
+ align: z.ZodOptional<z.ZodEnum<{
1034
+ start: "start";
1035
+ end: "end";
1036
+ center: "center";
1037
+ }>>;
1038
+ alignItemWithTrigger: z.ZodOptional<z.ZodBoolean>;
1039
+ alignOffset: z.ZodOptional<z.ZodUnknown>;
1040
+ anchor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
1041
+ path: z.ZodString;
1042
+ }, z.core.$strip>]>]>>;
1043
+ arrowPadding: z.ZodOptional<z.ZodNumber>;
1044
+ collisionAvoidance: z.ZodOptional<z.ZodUnknown>;
1045
+ collisionBoundary: z.ZodOptional<z.ZodUnknown>;
1046
+ collisionPadding: z.ZodOptional<z.ZodUnknown>;
1047
+ disableAnchorTracking: z.ZodOptional<z.ZodBoolean>;
1048
+ positionMethod: z.ZodOptional<z.ZodEnum<{
1049
+ absolute: "absolute";
1050
+ fixed: "fixed";
1051
+ }>>;
1052
+ side: z.ZodOptional<z.ZodEnum<{
1053
+ right: "right";
1054
+ top: "top";
1055
+ bottom: "bottom";
1056
+ left: "left";
1057
+ "inline-end": "inline-end";
1058
+ "inline-start": "inline-start";
1059
+ }>>;
1060
+ sideOffset: z.ZodOptional<z.ZodUnknown>;
1061
+ sticky: z.ZodOptional<z.ZodBoolean>;
1032
1062
  className: z.ZodOptional<z.ZodString>;
1033
1063
  render: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
1034
1064
  path: z.ZodString;
@@ -1231,6 +1261,7 @@ declare const TabsPropsSchema: z.ZodObject<{
1231
1261
  declare const TextPropsSchema: z.ZodObject<{
1232
1262
  variant: z.ZodOptional<z.ZodEnum<{
1233
1263
  body: "body";
1264
+ heading: "heading";
1234
1265
  success: "success";
1235
1266
  error: "error";
1236
1267
  secondary: "secondary";
@@ -2278,6 +2309,7 @@ declare const ComponentPropsSchemas: {
2278
2309
  page: z.ZodOptional<z.ZodNumber>;
2279
2310
  perPage: z.ZodOptional<z.ZodNumber>;
2280
2311
  totalCount: z.ZodOptional<z.ZodNumber>;
2312
+ hasNextPage: z.ZodOptional<z.ZodBoolean>;
2281
2313
  className: z.ZodOptional<z.ZodString>;
2282
2314
  labels: z.ZodOptional<z.ZodUnknown>;
2283
2315
  children: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
@@ -2341,6 +2373,35 @@ declare const ComponentPropsSchemas: {
2341
2373
  isDarkMode: z.ZodOptional<z.ZodBoolean>;
2342
2374
  }, z.core.$strip>;
2343
2375
  readonly Select: z.ZodObject<{
2376
+ align: z.ZodOptional<z.ZodEnum<{
2377
+ start: "start";
2378
+ end: "end";
2379
+ center: "center";
2380
+ }>>;
2381
+ alignItemWithTrigger: z.ZodOptional<z.ZodBoolean>;
2382
+ alignOffset: z.ZodOptional<z.ZodUnknown>;
2383
+ anchor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
2384
+ path: z.ZodString;
2385
+ }, z.core.$strip>]>]>>;
2386
+ arrowPadding: z.ZodOptional<z.ZodNumber>;
2387
+ collisionAvoidance: z.ZodOptional<z.ZodUnknown>;
2388
+ collisionBoundary: z.ZodOptional<z.ZodUnknown>;
2389
+ collisionPadding: z.ZodOptional<z.ZodUnknown>;
2390
+ disableAnchorTracking: z.ZodOptional<z.ZodBoolean>;
2391
+ positionMethod: z.ZodOptional<z.ZodEnum<{
2392
+ absolute: "absolute";
2393
+ fixed: "fixed";
2394
+ }>>;
2395
+ side: z.ZodOptional<z.ZodEnum<{
2396
+ right: "right";
2397
+ top: "top";
2398
+ bottom: "bottom";
2399
+ left: "left";
2400
+ "inline-end": "inline-end";
2401
+ "inline-start": "inline-start";
2402
+ }>>;
2403
+ sideOffset: z.ZodOptional<z.ZodUnknown>;
2404
+ sticky: z.ZodOptional<z.ZodBoolean>;
2344
2405
  className: z.ZodOptional<z.ZodString>;
2345
2406
  render: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
2346
2407
  path: z.ZodString;
@@ -2543,6 +2604,7 @@ declare const ComponentPropsSchemas: {
2543
2604
  readonly Text: z.ZodObject<{
2544
2605
  variant: z.ZodOptional<z.ZodEnum<{
2545
2606
  body: "body";
2607
+ heading: "heading";
2546
2608
  success: "success";
2547
2609
  error: "error";
2548
2610
  secondary: "secondary";