@cloudflare/kumo 1.2.0 → 1.4.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 (148) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/ai/USAGE.md +193 -0
  3. package/ai/component-registry.json +1492 -215
  4. package/ai/component-registry.md +524 -66
  5. package/ai/schemas.ts +366 -107
  6. package/dist/.build-complete +1 -1
  7. package/dist/badge-Dc99vsfo.js.map +1 -1
  8. package/dist/banner-4fkH6Sbt.js.map +1 -1
  9. package/dist/breadcrumbs-DyKi7BcP.js.map +1 -1
  10. package/dist/button-Bh96oxRL.js.map +1 -1
  11. package/dist/catalog.js +1 -1
  12. package/dist/checkbox-C1LPq8eL.js.map +1 -1
  13. package/dist/clipboard-text-CJSI9X2m.js.map +1 -1
  14. package/dist/cloudflare-logo-Dqd1VD9z.js +166 -0
  15. package/dist/cloudflare-logo-Dqd1VD9z.js.map +1 -0
  16. package/dist/code-T2wPDiM0.js.map +1 -1
  17. package/dist/collapsible-OBNkTO48.js.map +1 -1
  18. package/dist/combobox-CWxn5aHA.js.map +1 -1
  19. package/dist/command-line/cli.js +43 -18
  20. package/dist/command-line/commands/ai.js +23 -0
  21. package/dist/command-line/commands/blocks.js +2 -2
  22. package/dist/command-line/commands/ls.js +2 -2
  23. package/dist/{command-palette-BxmGYxBv.js → command-palette-J50WKjS7.js} +14 -8
  24. package/dist/command-palette-J50WKjS7.js.map +1 -0
  25. package/dist/components/cloudflare-logo.js +10 -0
  26. package/dist/components/cloudflare-logo.js.map +1 -0
  27. package/dist/components/command-palette.js +1 -1
  28. package/dist/components/dialog.js +1 -1
  29. package/dist/components/popover.js +1 -1
  30. package/dist/date-range-picker-CbKEQ9pi.js.map +1 -1
  31. package/dist/{dialog-BxXPA2vI.js → dialog-x9n9wI13.js} +18 -18
  32. package/dist/dialog-x9n9wI13.js.map +1 -0
  33. package/dist/dropdown-BAyk1knz.js.map +1 -1
  34. package/dist/empty-D03cbzRS.js.map +1 -1
  35. package/dist/field-B7ORz5ej.js.map +1 -1
  36. package/dist/grid-DKajRHh8.js.map +1 -1
  37. package/dist/index.js +274 -122
  38. package/dist/index.js.map +1 -1
  39. package/dist/input-D6YgDfDG.js.map +1 -1
  40. package/dist/label-B4FY8MX_.js.map +1 -1
  41. package/dist/layer-card-C8j5Hkkj.js.map +1 -1
  42. package/dist/link-CcuZKqob.js.map +1 -1
  43. package/dist/loader-DHGMYlC6.js.map +1 -1
  44. package/dist/menubar-CzimiryS.js.map +1 -1
  45. package/dist/meter-BrJnHJ3Q.js.map +1 -1
  46. package/dist/pagination-D0x9KQSk.js.map +1 -1
  47. package/dist/{popover-BfGLC2s6.js → popover-CtKDH8Yc.js} +8 -8
  48. package/dist/popover-CtKDH8Yc.js.map +1 -0
  49. package/dist/radio-CYejLANA.js.map +1 -1
  50. package/dist/schemas-DCw6TIy0.js +3859 -0
  51. package/dist/{schemas-C2YJKpDC.js.map → schemas-DCw6TIy0.js.map} +1 -1
  52. package/dist/select-D4rKQAax.js.map +1 -1
  53. package/dist/sensitive-input-DYvAmxkN.js.map +1 -1
  54. package/dist/src/blocks/delete-resource/delete-resource.d.ts +46 -0
  55. package/dist/src/blocks/delete-resource/delete-resource.d.ts.map +1 -0
  56. package/dist/src/blocks/delete-resource/index.d.ts +2 -0
  57. package/dist/src/blocks/delete-resource/index.d.ts.map +1 -0
  58. package/dist/src/command-line/commands/ai.d.ts +10 -0
  59. package/dist/src/command-line/commands/ai.d.ts.map +1 -0
  60. package/dist/src/components/badge/badge.d.ts +31 -4
  61. package/dist/src/components/badge/badge.d.ts.map +1 -1
  62. package/dist/src/components/banner/banner.d.ts +39 -4
  63. package/dist/src/components/banner/banner.d.ts.map +1 -1
  64. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts +35 -0
  65. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts.map +1 -1
  66. package/dist/src/components/button/button.d.ts +86 -0
  67. package/dist/src/components/button/button.d.ts.map +1 -1
  68. package/dist/src/components/checkbox/checkbox.d.ts +7 -0
  69. package/dist/src/components/checkbox/checkbox.d.ts.map +1 -1
  70. package/dist/src/components/clipboard-text/clipboard-text.d.ts +28 -3
  71. package/dist/src/components/clipboard-text/clipboard-text.d.ts.map +1 -1
  72. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts +133 -0
  73. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts.map +1 -0
  74. package/dist/src/components/cloudflare-logo/index.d.ts +2 -0
  75. package/dist/src/components/cloudflare-logo/index.d.ts.map +1 -0
  76. package/dist/src/components/code/code.d.ts +38 -6
  77. package/dist/src/components/code/code.d.ts.map +1 -1
  78. package/dist/src/components/collapsible/collapsible.d.ts +10 -0
  79. package/dist/src/components/collapsible/collapsible.d.ts.map +1 -1
  80. package/dist/src/components/combobox/combobox.d.ts +61 -0
  81. package/dist/src/components/combobox/combobox.d.ts.map +1 -1
  82. package/dist/src/components/command-palette/command-palette.d.ts +41 -6
  83. package/dist/src/components/command-palette/command-palette.d.ts.map +1 -1
  84. package/dist/src/components/date-range-picker/date-range-picker.d.ts +57 -4
  85. package/dist/src/components/date-range-picker/date-range-picker.d.ts.map +1 -1
  86. package/dist/src/components/dialog/dialog.d.ts +28 -1
  87. package/dist/src/components/dialog/dialog.d.ts.map +1 -1
  88. package/dist/src/components/dropdown/dropdown.d.ts +33 -0
  89. package/dist/src/components/dropdown/dropdown.d.ts.map +1 -1
  90. package/dist/src/components/empty/empty.d.ts +35 -0
  91. package/dist/src/components/empty/empty.d.ts.map +1 -1
  92. package/dist/src/components/field/field.d.ts +34 -4
  93. package/dist/src/components/field/field.d.ts.map +1 -1
  94. package/dist/src/components/grid/grid.d.ts +45 -17
  95. package/dist/src/components/grid/grid.d.ts.map +1 -1
  96. package/dist/src/components/input/input.d.ts +15 -0
  97. package/dist/src/components/input/input.d.ts.map +1 -1
  98. package/dist/src/components/label/label.d.ts +16 -5
  99. package/dist/src/components/label/label.d.ts.map +1 -1
  100. package/dist/src/components/layer-card/layer-card.d.ts +13 -0
  101. package/dist/src/components/layer-card/layer-card.d.ts.map +1 -1
  102. package/dist/src/components/link/link.d.ts +20 -0
  103. package/dist/src/components/link/link.d.ts.map +1 -1
  104. package/dist/src/components/loader/loader.d.ts +34 -0
  105. package/dist/src/components/loader/loader.d.ts.map +1 -1
  106. package/dist/src/components/menubar/menubar.d.ts +44 -0
  107. package/dist/src/components/menubar/menubar.d.ts.map +1 -1
  108. package/dist/src/components/meter/meter.d.ts +26 -0
  109. package/dist/src/components/meter/meter.d.ts.map +1 -1
  110. package/dist/src/components/pagination/pagination.d.ts +25 -0
  111. package/dist/src/components/pagination/pagination.d.ts.map +1 -1
  112. package/dist/src/components/popover/popover.d.ts +33 -5
  113. package/dist/src/components/popover/popover.d.ts.map +1 -1
  114. package/dist/src/components/radio/radio.d.ts +22 -0
  115. package/dist/src/components/radio/radio.d.ts.map +1 -1
  116. package/dist/src/components/select/select.d.ts +42 -20
  117. package/dist/src/components/select/select.d.ts.map +1 -1
  118. package/dist/src/components/sensitive-input/sensitive-input.d.ts +30 -6
  119. package/dist/src/components/sensitive-input/sensitive-input.d.ts.map +1 -1
  120. package/dist/src/components/surface/surface.d.ts +18 -6
  121. package/dist/src/components/surface/surface.d.ts.map +1 -1
  122. package/dist/src/components/switch/switch.d.ts +14 -0
  123. package/dist/src/components/switch/switch.d.ts.map +1 -1
  124. package/dist/src/components/table/table.d.ts +33 -0
  125. package/dist/src/components/table/table.d.ts.map +1 -1
  126. package/dist/src/components/tabs/tabs.d.ts +48 -9
  127. package/dist/src/components/tabs/tabs.d.ts.map +1 -1
  128. package/dist/src/components/text/text.d.ts +35 -7
  129. package/dist/src/components/text/text.d.ts.map +1 -1
  130. package/dist/src/components/toast/toast.d.ts +34 -0
  131. package/dist/src/components/toast/toast.d.ts.map +1 -1
  132. package/dist/src/components/tooltip/tooltip.d.ts +41 -0
  133. package/dist/src/components/tooltip/tooltip.d.ts.map +1 -1
  134. package/dist/src/index.d.ts +31 -0
  135. package/dist/src/index.d.ts.map +1 -1
  136. package/dist/styles/kumo-standalone.css +1 -1
  137. package/dist/surface-BIC6CXiz.js.map +1 -1
  138. package/dist/switch-z7FE1nQE.js.map +1 -1
  139. package/dist/table-Sd2Etb1N.js.map +1 -1
  140. package/dist/tabs-DAEeuQLd.js.map +1 -1
  141. package/dist/text-BEhqwMfe.js.map +1 -1
  142. package/dist/toast-B8ebpHaU.js.map +1 -1
  143. package/dist/tooltip-C4DRhJi1.js.map +1 -1
  144. package/package.json +6 -2
  145. package/dist/command-palette-BxmGYxBv.js.map +0 -1
  146. package/dist/dialog-BxXPA2vI.js.map +0 -1
  147. package/dist/popover-BfGLC2s6.js.map +0 -1
  148. package/dist/schemas-C2YJKpDC.js +0 -3543
@@ -1,4 +1,5 @@
1
1
  import { ReactNode } from 'react';
2
+ /** Tabs variant definitions. */
2
3
  export declare const KUMO_TABS_VARIANTS: {
3
4
  readonly variant: readonly ["segmented", "underline"];
4
5
  };
@@ -29,36 +30,74 @@ export declare const KUMO_TABS_STYLING: {
29
30
  };
30
31
  };
31
32
  export interface KumoTabsVariantsProps {
33
+ /**
34
+ * Tab style.
35
+ * - `"segmented"` — Pill-shaped indicator on a filled track
36
+ * - `"underline"` — Underline indicator below tab text
37
+ * @default "segmented"
38
+ */
32
39
  variant?: (typeof KUMO_TABS_VARIANTS.variant)[number];
33
40
  }
41
+ /** Configuration for a single tab within the Tabs component. */
34
42
  export type TabsItem = {
43
+ /** Unique identifier for the tab, used as the controlled value. */
35
44
  value: string;
45
+ /** Display content for the tab trigger. */
36
46
  label: ReactNode;
47
+ /** Additional CSS classes for this tab trigger. */
37
48
  className?: string;
38
- /** Optional render function to customize the tab element (e.g., for links) */
49
+ /** Custom render function to replace the tab element (e.g. for link-based tabs). */
39
50
  render?: (props: Record<string, unknown>) => React.ReactElement;
40
51
  };
52
+ /**
53
+ * Tabs component props.
54
+ *
55
+ * @example
56
+ * ```tsx
57
+ * <Tabs
58
+ * tabs={[
59
+ * { value: "overview", label: "Overview" },
60
+ * { value: "settings", label: "Settings" },
61
+ * ]}
62
+ * value={activeTab}
63
+ * onValueChange={setActiveTab}
64
+ * />
65
+ * ```
66
+ */
41
67
  export type TabsProps = KumoTabsVariantsProps & {
42
- /** Array of tab items to render */
68
+ /** Array of tab items to render. */
43
69
  tabs?: TabsItem[];
44
70
  /** Controlled value. When set, component becomes controlled. */
45
71
  value?: string;
46
72
  /** Default selected value for uncontrolled mode. Ignored when `value` is set. */
47
73
  selectedValue?: string;
48
- /** Callback fired when the active tab changes */
74
+ /** Callback fired when the active tab changes. */
49
75
  onValueChange?: (value: string) => void;
50
76
  /**
51
- * When true, tabs are activated immediately upon receiving focus via arrow keys.
52
- * When false (default), tabs receive focus but require Enter/Space to activate.
53
- * Set to true for better keyboard UX in most cases.
77
+ * When `true`, tabs are activated immediately upon receiving focus via arrow keys.
78
+ * When `false` (default), tabs receive focus but require Enter/Space to activate.
54
79
  */
55
80
  activateOnFocus?: boolean;
56
- /** Additional class name for the root element */
81
+ /** Additional CSS classes for the root element. */
57
82
  className?: string;
58
- /** Additional class name for the tab list element */
83
+ /** Additional CSS classes for the tab list element. */
59
84
  listClassName?: string;
60
- /** Additional class name for the indicator element */
85
+ /** Additional CSS classes for the indicator element. */
61
86
  indicatorClassName?: string;
62
87
  };
88
+ /**
89
+ * Tab navigation component with segmented or underline style.
90
+ * Built on Base UI Tabs with animated active indicator.
91
+ *
92
+ * @example
93
+ * ```tsx
94
+ * <Tabs
95
+ * variant="segmented"
96
+ * tabs={[{ value: "tab1", label: "Tab 1" }, { value: "tab2", label: "Tab 2" }]}
97
+ * value={active}
98
+ * onValueChange={setActive}
99
+ * />
100
+ * ```
101
+ */
63
102
  export declare function Tabs({ tabs, value, selectedValue, onValueChange, activateOnFocus, className, listClassName, indicatorClassName, variant, }: TabsProps): import("react/jsx-runtime").JSX.Element | null;
64
103
  //# sourceMappingURL=tabs.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBpB,CAAC;AAGX,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,qBAAqB,GAAG;IAC9C,mCAAmC;IACnC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,OAA4C,GAC7C,EAAE,SAAS,kDAqEX"}
1
+ {"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,gCAAgC;AAChC,eAAO,MAAM,kBAAkB;;CAErB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBpB,CAAC;AAGX,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,gEAAgE;AAChE,MAAM,MAAM,QAAQ,GAAG;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC;CACjE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,qBAAqB,GAAG;IAC9C,oCAAoC;IACpC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,OAA4C,GAC7C,EAAE,SAAS,kDAqEX"}
@@ -1,4 +1,5 @@
1
1
  import { CSSProperties, ComponentPropsWithoutRef, ElementRef, ForwardedRef, ElementType } from 'react';
2
+ /** Text variant and size definitions mapping names to their Tailwind classes. */
2
3
  export declare const KUMO_TEXT_VARIANTS: {
3
4
  readonly variant: {
4
5
  readonly heading1: {
@@ -131,19 +132,46 @@ type TextPropsInternal<Variant extends TextVariant = "body"> = BaseTextProps & (
131
132
  size?: never;
132
133
  } : never);
133
134
  /**
134
- * Props for the Text component.
135
- * @description A typography component for rendering text with consistent styling.
135
+ * Text component props.
136
+ *
137
+ * @example
138
+ * ```tsx
139
+ * <Text variant="heading1">Page Title</Text>
140
+ * <Text variant="body">Default paragraph text.</Text>
141
+ * <Text variant="secondary" size="sm">Muted helper text</Text>
142
+ * <Text variant="error">Something went wrong</Text>
143
+ * <Text variant="mono">console.log("code")</Text>
144
+ * ```
136
145
  */
137
146
  export interface TextProps {
138
- /** Text style variant */
147
+ /**
148
+ * Text style variant. Determines color, font, and weight.
149
+ * - `"heading1"` — Large page title (30px, semibold)
150
+ * - `"heading2"` — Section title (24px, semibold)
151
+ * - `"heading3"` — Subsection title (18px, semibold)
152
+ * - `"body"` — Default body text
153
+ * - `"secondary"` — Muted text for secondary information
154
+ * - `"success"` — Success state text
155
+ * - `"error"` — Error state text
156
+ * - `"mono"` — Monospace text for code
157
+ * - `"mono-secondary"` — Muted monospace text
158
+ * @default "body"
159
+ */
139
160
  variant?: KumoTextVariant;
140
- /** Text size (only applies to body/secondary/success/error variants) */
161
+ /**
162
+ * Text size (only applies to body/secondary/success/error variants).
163
+ * - `"xs"` — 12px
164
+ * - `"sm"` — 14px
165
+ * - `"base"` — 16px
166
+ * - `"lg"` — 18px
167
+ * @default "base"
168
+ */
141
169
  size?: KumoTextSize;
142
- /** Whether to use bold font weight (only applies to body variants) */
170
+ /** Whether to use bold font weight (only applies to body variants). */
143
171
  bold?: boolean;
144
- /** The element type to render as */
172
+ /** The HTML element type to render as (e.g. `"span"`, `"p"`, `"h1"`). Auto-selected based on variant if omitted. */
145
173
  as?: ElementType;
146
- /** Child text content */
174
+ /** Text content. */
147
175
  children?: React.ReactNode;
148
176
  }
149
177
  export declare const Text: <Variant extends TextVariant = "body">(props: TextPropsInternal<Variant> & {
@@ -1 +1 @@
1
- {"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/components/text/text.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,YAAY,EAGjB,KAAK,WAAW,EACjB,MAAM,OAAO,CAAC;AAGf,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BpB,CAAC;AAGX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAA4C,EAC5C,IAAsC,GACvC,GAAE,qBAA0B,UAK5B;AAGD,KAAK,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AACpD,KAAK,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AACvD,KAAK,SAAS,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAC3C,KAAK,QAAQ,GAAG,YAAY,CAAC;AAC7B,KAAK,WAAW,GAAG,eAAe,CAAC;AAEnC,KAAK,aAAa,GAAG,IAAI,CACvB,wBAAwB,CAAC,MAAM,CAAC,EAChC,WAAW,GAAG,OAAO,CACtB,GAAG;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,KAAK,iBAAiB,CAAC,OAAO,SAAS,WAAW,GAAG,MAAM,IAAI,aAAa,GAC1E,CAAC,OAAO,SAAS,IAAI,GACjB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GACD,OAAO,SAAS,SAAS,GACvB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,GACD,OAAO,SAAS,OAAO,GACrB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,GACD,KAAK,CAAC,CAAC;AAEjB;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,wEAAwE;IACxE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAkDD,eAAO,MAAM,IAAI,EAAwB,CAAC,OAAO,SAAS,WAAW,GAAG,MAAM,EAC5E,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAClC,GAAG,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;CACxC,KACE,KAAK,CAAC,YAAY,CAAC"}
1
+ {"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/components/text/text.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,YAAY,EAGjB,KAAK,WAAW,EACjB,MAAM,OAAO,CAAC;AAGf,iFAAiF;AACjF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BpB,CAAC;AAGX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC,OAAO,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAA4C,EAC5C,IAAsC,GACvC,GAAE,qBAA0B,UAK5B;AAGD,KAAK,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AACpD,KAAK,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AACvD,KAAK,SAAS,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAC3C,KAAK,QAAQ,GAAG,YAAY,CAAC;AAC7B,KAAK,WAAW,GAAG,eAAe,CAAC;AAEnC,KAAK,aAAa,GAAG,IAAI,CACvB,wBAAwB,CAAC,MAAM,CAAC,EAChC,WAAW,GAAG,OAAO,CACtB,GAAG;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,EAAE,CAAC,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,KAAK,iBAAiB,CAAC,OAAO,SAAS,WAAW,GAAG,MAAM,IAAI,aAAa,GAC1E,CAAC,OAAO,SAAS,IAAI,GACjB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GACD,OAAO,SAAS,SAAS,GACvB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,GACD,OAAO,SAAS,OAAO,GACrB;IACE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,GACD,KAAK,CAAC,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oHAAoH;IACpH,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA6DD,eAAO,MAAM,IAAI,EAAwB,CAAC,OAAO,SAAS,WAAW,GAAG,MAAM,EAC5E,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAClC,GAAG,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;CACxC,KACE,KAAK,CAAC,YAAY,CAAC"}
@@ -81,7 +81,26 @@ export interface KumoToastVariantsProps {
81
81
  variant?: KumoToastVariant;
82
82
  }
83
83
  export declare function toastVariants({ variant, }?: KumoToastVariantsProps): string;
84
+ /**
85
+ * Toasty component props.
86
+ *
87
+ * Wrap your app with `<Toasty>` to enable toast notifications.
88
+ * Use `Toast.useToastManager().notify(…)` to create toasts.
89
+ *
90
+ * @example
91
+ * ```tsx
92
+ * // 1. Wrap your app
93
+ * <Toasty>
94
+ * <App />
95
+ * </Toasty>
96
+ *
97
+ * // 2. Show a toast from any child component
98
+ * const toasts = Toast.useToastManager();
99
+ * toasts.notify({ title: "Saved", description: "Changes saved successfully." });
100
+ * ```
101
+ */
84
102
  export interface ToastyProps extends KumoToastVariantsProps {
103
+ /** Application content. Toasts render via a portal above this. */
85
104
  children: React.ReactNode;
86
105
  }
87
106
  type KumoToastOptionsBase = {
@@ -111,6 +130,21 @@ export declare const createKumoToastManager: () => import('@base-ui/react/toast'
111
130
  error: KumoToastManagerAddOptions<any> | ((error: Error) => KumoToastManagerAddOptions<any>);
112
131
  }) => any;
113
132
  };
133
+ /**
134
+ * Toasty — toast notification provider and viewport.
135
+ *
136
+ * Renders a `Toast.Provider` with a fixed-position viewport in the bottom-right corner.
137
+ * Toasts stack with smooth enter/exit animations, swipe-to-dismiss, and expand-on-hover.
138
+ *
139
+ * Built on `@base-ui/react/toast`.
140
+ *
141
+ * @example
142
+ * ```tsx
143
+ * <Toasty>
144
+ * <App />
145
+ * </Toasty>
146
+ * ```
147
+ */
114
148
  export declare function Toasty({ children }: ToastyProps): import("react/jsx-runtime").JSX.Element;
115
149
  export {};
116
150
  //# sourceMappingURL=toast.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../src/components/toast/toast.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACtB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAU,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BrB,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,GAC9C,GAAE,sBAA2B,UAO7B;AAED,MAAM,WAAW,WAAY,SAAQ,sBAAsB;IACzD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,KAAK,oBAAoB,GAAG;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,GACnE,oBAAoB,CAAC;AAEvB,MAAM,MAAM,0BAA0B,CAAC,IAAI,SAAS,MAAM,IACxD,sBAAsB,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC;AA2DtD,eAAO,MAAM,mBAAmB;YAIF,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;+FAvDvC,0BAA0B,CAAC,GAAG,CAAC;;8IAMjC,MAAM,WAAW,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;4KAM5D,CAAC;iBAGE,0BAA0B,CAAC,GAAG,CAAC;iEAGtB,0BAA0B,CAAC,GAAG,CAAC;0DAGpC,KAAK,KAAK,0BAA0B,CAAC,GAAG,CAAC;;CAoC7D,CAAC;AAEF,eAAO,MAAM,sBAAsB;mBA3DhB,0BAA0B,CAAC,GAAG,CAAC;iBAMjC,MAAM,WAAW,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;cAM5D,CAAC;iBAGE,0BAA0B,CAAC,GAAG,CAAC;iEAGtB,0BAA0B,CAAC,GAAG,CAAC;0DAGpC,KAAK,KAAK,0BAA0B,CAAC,GAAG,CAAC;;CAwC7D,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,2CAW/C"}
1
+ {"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../src/components/toast/toast.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACtB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAU,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCtB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BrB,CAAC;AAGX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC,OAAO,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,OAA6C,GAC9C,GAAE,sBAA2B,UAO7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAY,SAAQ,sBAAsB;IACzD,kEAAkE;IAClE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,KAAK,oBAAoB,GAAG;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,GACnE,oBAAoB,CAAC;AAEvB,MAAM,MAAM,0BAA0B,CAAC,IAAI,SAAS,MAAM,IACxD,sBAAsB,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC;AA2DtD,eAAO,MAAM,mBAAmB;YAIF,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;+FAvDvC,0BAA0B,CAAC,GAAG,CAAC;;8IAMjC,MAAM,WAAW,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;4KAM5D,CAAC;iBAGE,0BAA0B,CAAC,GAAG,CAAC;iEAGtB,0BAA0B,CAAC,GAAG,CAAC;0DAGpC,KAAK,KAAK,0BAA0B,CAAC,GAAG,CAAC;;CAoC7D,CAAC;AAEF,eAAO,MAAM,sBAAsB;mBA3DhB,0BAA0B,CAAC,GAAG,CAAC;iBAMjC,MAAM,WAAW,OAAO,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC;cAM5D,CAAC;iBAGE,0BAA0B,CAAC,GAAG,CAAC;iEAGtB,0BAA0B,CAAC,GAAG,CAAC;0DAGpC,KAAK,KAAK,0BAA0B,CAAC,GAAG,CAAC;;CAwC7D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,2CAW/C"}
@@ -1,5 +1,6 @@
1
1
  import { Tooltip as TooltipBase } from '@base-ui/react/tooltip';
2
2
  import { ComponentPropsWithoutRef, ReactNode } from 'react';
3
+ /** Tooltip side variant definitions mapping positions to their Tailwind classes. */
3
4
  export declare const KUMO_TOOLTIP_VARIANTS: {
4
5
  readonly side: {
5
6
  readonly top: {
@@ -25,6 +26,14 @@ export declare const KUMO_TOOLTIP_DEFAULT_VARIANTS: {
25
26
  };
26
27
  export type KumoTooltipSide = keyof typeof KUMO_TOOLTIP_VARIANTS.side;
27
28
  export interface KumoTooltipVariantsProps {
29
+ /**
30
+ * Preferred side of the trigger to render the tooltip.
31
+ * - `"top"` — Tooltip appears above the trigger
32
+ * - `"bottom"` — Tooltip appears below the trigger
33
+ * - `"left"` — Tooltip appears to the left of the trigger
34
+ * - `"right"` — Tooltip appears to the right of the trigger
35
+ * @default "top"
36
+ */
28
37
  side?: KumoTooltipSide;
29
38
  }
30
39
  export declare function tooltipVariants({ side, }?: KumoTooltipVariantsProps): string;
@@ -32,12 +41,44 @@ export declare const TooltipProvider: import('react').FC<import('@base-ui/react/
32
41
  type BaseTooltipProps = ComponentPropsWithoutRef<typeof TooltipBase.Root>;
33
42
  /** Alignment options for tooltip positioning. Source: PositionerProps["align"] */
34
43
  type TooltipAlign = "start" | "center" | "end";
44
+ /**
45
+ * Tooltip component props.
46
+ *
47
+ * @example
48
+ * ```tsx
49
+ * <TooltipProvider>
50
+ * <Tooltip content="Add new item" asChild>
51
+ * <Button shape="square" icon={PlusIcon} />
52
+ * </Tooltip>
53
+ * </TooltipProvider>
54
+ * ```
55
+ */
35
56
  export type TooltipProps = BaseTooltipProps & KumoTooltipVariantsProps & {
57
+ /**
58
+ * Alignment on the axis perpendicular to `side`.
59
+ * - `"start"` — Align to the start edge
60
+ * - `"center"` — Center-aligned
61
+ * - `"end"` — Align to the end edge
62
+ */
36
63
  align?: TooltipAlign;
64
+ /** When `true`, the trigger wraps the child element instead of adding a wrapper. */
37
65
  asChild?: boolean;
66
+ /** Additional CSS classes merged via `cn()`. */
38
67
  className?: string;
68
+ /** Content to display inside the tooltip popup. */
39
69
  content: ReactNode;
40
70
  };
71
+ /**
72
+ * Accessible popup that shows additional information on hover/focus.
73
+ * Wrap your app or section with `<TooltipProvider>` to enable delay grouping.
74
+ *
75
+ * @example
76
+ * ```tsx
77
+ * <Tooltip content="Save changes" asChild>
78
+ * <Button variant="primary">Save</Button>
79
+ * </Tooltip>
80
+ * ```
81
+ */
41
82
  export declare function Tooltip({ content, children, align, asChild, side, className, ...props }: TooltipProps): import("react/jsx-runtime").JSX.Element;
42
83
  export {};
43
84
  //# sourceMappingURL=tooltip.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/tooltip/tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEX,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAGX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAyC,GAC1C,GAAE,wBAA6B,UAY/B;AAED,eAAO,MAAM,eAAe,2EAAuB,CAAC;AAEpD,KAAK,gBAAgB,GAAG,wBAAwB,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAI1E,kFAAkF;AAClF,KAAK,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,gBAAgB,GACzC,wBAAwB,GAAG;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;CACpB,CAAC;AAEJ,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,GAAG,KAAK,EACT,EAAE,YAAY,2CAuCd"}
1
+ {"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/tooltip/tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjE,oFAAoF;AACpF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEX,eAAO,MAAM,6BAA6B;;CAEhC,CAAC;AAGX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,qBAAqB,CAAC,IAAI,CAAC;AAEtE,MAAM,WAAW,wBAAwB;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAyC,GAC1C,GAAE,wBAA6B,UAY/B;AAED,eAAO,MAAM,eAAe,2EAAuB,CAAC;AAEpD,KAAK,gBAAgB,GAAG,wBAAwB,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAI1E,kFAAkF;AAClF,KAAK,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GACzC,wBAAwB,GAAG;IACzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,SAAS,CAAC;CACpB,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,GAAG,KAAK,EACT,EAAE,YAAY,2CAuCd"}
@@ -1,3 +1,32 @@
1
+ /**
2
+ * @module @cloudflare/kumo
3
+ *
4
+ * Cloudflare's React component library built on Base UI and Tailwind CSS v4.
5
+ *
6
+ * **Key rules:**
7
+ * - Use **semantic tokens only** (`bg-kumo-base`, `text-kumo-default`, etc.) — never raw Tailwind colors.
8
+ * - **No `dark:` variant** — light/dark mode is handled automatically via CSS `light-dark()`.
9
+ * - Merge custom classes with the `cn()` utility exported from this package.
10
+ * - Wrap your app with the kumo CSS import: `import "@cloudflare/kumo/styles"`.
11
+ *
12
+ * **Component categories:**
13
+ * - **Action:** Button, ClipboardText
14
+ * - **Display:** Badge, Breadcrumbs, Code, Empty, LayerCard, Meter, Text
15
+ * - **Feedback:** Banner, Loader, Toast
16
+ * - **Input:** Checkbox, Combobox, DateRangePicker, Field, Input, Radio, Select, SensitiveInput, Switch
17
+ * - **Layout:** Grid, Surface
18
+ * - **Navigation:** CommandPalette, MenuBar, Pagination, Tabs
19
+ * - **Overlay:** Dialog, DropdownMenu, Popover, Tooltip
20
+ * - **Other:** Label, Link
21
+ *
22
+ * **Blocks** (composite page-level components) are NOT exported here.
23
+ * Install them via the CLI: `npx @cloudflare/kumo add <block-name>`.
24
+ *
25
+ * **AI resources:** See `@cloudflare/kumo/ai/component-registry.json` for full
26
+ * component metadata including prop descriptions, variant values, and examples.
27
+ *
28
+ * @see {@link https://kumo-ui.com} — Documentation site
29
+ */
1
30
  export { Badge, type BadgeVariant } from './components/badge';
2
31
  export { Banner, BannerVariant } from './components/banner';
3
32
  export { Button, RefreshButton, LinkButton, buttonVariants, type ButtonProps, type LinkButtonProps, } from './components/button';
@@ -13,6 +42,7 @@ export { Field, type FieldProps, type FieldErrorMatch, fieldVariants, KUMO_FIELD
13
42
  export { Label, type LabelProps, labelVariants, labelContentVariants, KUMO_LABEL_VARIANTS, KUMO_LABEL_DEFAULT_VARIANTS, } from './components/label';
14
43
  export { Input, inputVariants, type InputProps, InputArea, type InputAreaProps, InputGroup, } from './components/input';
15
44
  export { LayerCard } from './components/layer-card';
45
+ export { DeleteResource, KUMO_DELETE_RESOURCE_VARIANTS, KUMO_DELETE_RESOURCE_DEFAULT_VARIANTS, type DeleteResourceProps, } from './blocks/delete-resource';
16
46
  export { Loader, SkeletonLine } from './components/loader';
17
47
  export { MenuBar, useMenuNavigation } from './components/menubar';
18
48
  export { Meter } from './components/meter';
@@ -33,6 +63,7 @@ export { Link, linkVariants, KUMO_LINK_VARIANTS, KUMO_LINK_DEFAULT_VARIANTS, typ
33
63
  export { Breadcrumbs, type BreadcrumbsProps } from './components/breadcrumbs';
34
64
  export { Empty, type EmptyProps } from './components/empty';
35
65
  export { Grid, GridItem, gridVariants, gridItemVariants, KUMO_GRID_VARIANTS, KUMO_GRID_DEFAULT_VARIANTS, type GridProps, type GridItemProps, type KumoGridVariant, type KumoGridGap, } from './components/grid';
66
+ export { CloudflareLogo, KUMO_CLOUDFLARE_LOGO_VARIANTS, KUMO_CLOUDFLARE_LOGO_DEFAULT_VARIANTS, type CloudflareLogoProps, type CloudflareLogoVariant, type CloudflareLogoColor, PoweredByCloudflare, type PoweredByCloudflareProps, generateCloudflareLogoSvg, type GenerateCloudflareLogoSvgOptions, type CloudflareLogoSvgVariant, type CloudflareLogoSvgColor, } from './components/cloudflare-logo';
36
67
  export { cn, safeRandomId } from './utils/cn';
37
68
  export { LinkProvider, useLinkComponent, type LinkComponentProps, } from './utils/link-provider';
38
69
  export type { ComponentRegistry, ComponentSchema, ComponentStyling, ComponentType, PropSchema, SubComponentSchema, } from './registry/types';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}