@cloudflare/kumo 1.3.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 (138) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/ai/USAGE.md +193 -0
  3. package/ai/component-registry.json +1425 -237
  4. package/ai/component-registry.md +531 -67
  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/date-range-picker-CbKEQ9pi.js.map +1 -1
  29. package/dist/dialog-x9n9wI13.js.map +1 -1
  30. package/dist/dropdown-BAyk1knz.js.map +1 -1
  31. package/dist/empty-D03cbzRS.js.map +1 -1
  32. package/dist/field-B7ORz5ej.js.map +1 -1
  33. package/dist/grid-DKajRHh8.js.map +1 -1
  34. package/dist/index.js +67 -61
  35. package/dist/index.js.map +1 -1
  36. package/dist/input-D6YgDfDG.js.map +1 -1
  37. package/dist/label-B4FY8MX_.js.map +1 -1
  38. package/dist/layer-card-C8j5Hkkj.js.map +1 -1
  39. package/dist/link-CcuZKqob.js.map +1 -1
  40. package/dist/loader-DHGMYlC6.js.map +1 -1
  41. package/dist/menubar-CzimiryS.js.map +1 -1
  42. package/dist/meter-BrJnHJ3Q.js.map +1 -1
  43. package/dist/pagination-D0x9KQSk.js.map +1 -1
  44. package/dist/popover-CtKDH8Yc.js.map +1 -1
  45. package/dist/radio-CYejLANA.js.map +1 -1
  46. package/dist/schemas-DCw6TIy0.js +3859 -0
  47. package/dist/{schemas-C2YJKpDC.js.map → schemas-DCw6TIy0.js.map} +1 -1
  48. package/dist/select-D4rKQAax.js.map +1 -1
  49. package/dist/sensitive-input-DYvAmxkN.js.map +1 -1
  50. package/dist/src/command-line/commands/ai.d.ts +10 -0
  51. package/dist/src/command-line/commands/ai.d.ts.map +1 -0
  52. package/dist/src/components/badge/badge.d.ts +31 -4
  53. package/dist/src/components/badge/badge.d.ts.map +1 -1
  54. package/dist/src/components/banner/banner.d.ts +39 -4
  55. package/dist/src/components/banner/banner.d.ts.map +1 -1
  56. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts +35 -0
  57. package/dist/src/components/breadcrumbs/breadcrumbs.d.ts.map +1 -1
  58. package/dist/src/components/button/button.d.ts +86 -0
  59. package/dist/src/components/button/button.d.ts.map +1 -1
  60. package/dist/src/components/checkbox/checkbox.d.ts +7 -0
  61. package/dist/src/components/checkbox/checkbox.d.ts.map +1 -1
  62. package/dist/src/components/clipboard-text/clipboard-text.d.ts +28 -3
  63. package/dist/src/components/clipboard-text/clipboard-text.d.ts.map +1 -1
  64. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts +133 -0
  65. package/dist/src/components/cloudflare-logo/cloudflare-logo.d.ts.map +1 -0
  66. package/dist/src/components/cloudflare-logo/index.d.ts +2 -0
  67. package/dist/src/components/cloudflare-logo/index.d.ts.map +1 -0
  68. package/dist/src/components/code/code.d.ts +38 -6
  69. package/dist/src/components/code/code.d.ts.map +1 -1
  70. package/dist/src/components/collapsible/collapsible.d.ts +10 -0
  71. package/dist/src/components/collapsible/collapsible.d.ts.map +1 -1
  72. package/dist/src/components/combobox/combobox.d.ts +61 -0
  73. package/dist/src/components/combobox/combobox.d.ts.map +1 -1
  74. package/dist/src/components/command-palette/command-palette.d.ts +41 -6
  75. package/dist/src/components/command-palette/command-palette.d.ts.map +1 -1
  76. package/dist/src/components/date-range-picker/date-range-picker.d.ts +57 -4
  77. package/dist/src/components/date-range-picker/date-range-picker.d.ts.map +1 -1
  78. package/dist/src/components/dialog/dialog.d.ts +27 -0
  79. package/dist/src/components/dialog/dialog.d.ts.map +1 -1
  80. package/dist/src/components/dropdown/dropdown.d.ts +33 -0
  81. package/dist/src/components/dropdown/dropdown.d.ts.map +1 -1
  82. package/dist/src/components/empty/empty.d.ts +35 -0
  83. package/dist/src/components/empty/empty.d.ts.map +1 -1
  84. package/dist/src/components/field/field.d.ts +34 -4
  85. package/dist/src/components/field/field.d.ts.map +1 -1
  86. package/dist/src/components/grid/grid.d.ts +45 -17
  87. package/dist/src/components/grid/grid.d.ts.map +1 -1
  88. package/dist/src/components/input/input.d.ts +15 -0
  89. package/dist/src/components/input/input.d.ts.map +1 -1
  90. package/dist/src/components/label/label.d.ts +16 -5
  91. package/dist/src/components/label/label.d.ts.map +1 -1
  92. package/dist/src/components/layer-card/layer-card.d.ts +13 -0
  93. package/dist/src/components/layer-card/layer-card.d.ts.map +1 -1
  94. package/dist/src/components/link/link.d.ts +20 -0
  95. package/dist/src/components/link/link.d.ts.map +1 -1
  96. package/dist/src/components/loader/loader.d.ts +34 -0
  97. package/dist/src/components/loader/loader.d.ts.map +1 -1
  98. package/dist/src/components/menubar/menubar.d.ts +44 -0
  99. package/dist/src/components/menubar/menubar.d.ts.map +1 -1
  100. package/dist/src/components/meter/meter.d.ts +26 -0
  101. package/dist/src/components/meter/meter.d.ts.map +1 -1
  102. package/dist/src/components/pagination/pagination.d.ts +25 -0
  103. package/dist/src/components/pagination/pagination.d.ts.map +1 -1
  104. package/dist/src/components/popover/popover.d.ts +33 -5
  105. package/dist/src/components/popover/popover.d.ts.map +1 -1
  106. package/dist/src/components/radio/radio.d.ts +22 -0
  107. package/dist/src/components/radio/radio.d.ts.map +1 -1
  108. package/dist/src/components/select/select.d.ts +42 -20
  109. package/dist/src/components/select/select.d.ts.map +1 -1
  110. package/dist/src/components/sensitive-input/sensitive-input.d.ts +30 -6
  111. package/dist/src/components/sensitive-input/sensitive-input.d.ts.map +1 -1
  112. package/dist/src/components/surface/surface.d.ts +18 -6
  113. package/dist/src/components/surface/surface.d.ts.map +1 -1
  114. package/dist/src/components/switch/switch.d.ts +14 -0
  115. package/dist/src/components/switch/switch.d.ts.map +1 -1
  116. package/dist/src/components/table/table.d.ts +33 -0
  117. package/dist/src/components/table/table.d.ts.map +1 -1
  118. package/dist/src/components/tabs/tabs.d.ts +48 -9
  119. package/dist/src/components/tabs/tabs.d.ts.map +1 -1
  120. package/dist/src/components/text/text.d.ts +35 -7
  121. package/dist/src/components/text/text.d.ts.map +1 -1
  122. package/dist/src/components/toast/toast.d.ts +34 -0
  123. package/dist/src/components/toast/toast.d.ts.map +1 -1
  124. package/dist/src/components/tooltip/tooltip.d.ts +41 -0
  125. package/dist/src/components/tooltip/tooltip.d.ts.map +1 -1
  126. package/dist/src/index.d.ts +30 -0
  127. package/dist/src/index.d.ts.map +1 -1
  128. package/dist/styles/kumo-standalone.css +1 -1
  129. package/dist/surface-BIC6CXiz.js.map +1 -1
  130. package/dist/switch-z7FE1nQE.js.map +1 -1
  131. package/dist/table-Sd2Etb1N.js.map +1 -1
  132. package/dist/tabs-DAEeuQLd.js.map +1 -1
  133. package/dist/text-BEhqwMfe.js.map +1 -1
  134. package/dist/toast-B8ebpHaU.js.map +1 -1
  135. package/dist/tooltip-C4DRhJi1.js.map +1 -1
  136. package/package.json +6 -2
  137. package/dist/command-palette-BxmGYxBv.js.map +0 -1
  138. package/dist/schemas-C2YJKpDC.js +0 -3543
@@ -1,3 +1,4 @@
1
+ /** ClipboardText size variant definitions mapping sizes to their Tailwind classes. */
1
2
  export declare const KUMO_CLIPBOARD_TEXT_VARIANTS: {
2
3
  readonly size: {
3
4
  readonly sm: {
@@ -22,17 +23,41 @@ export declare const KUMO_CLIPBOARD_TEXT_DEFAULT_VARIANTS: {
22
23
  };
23
24
  export type KumoClipboardTextSize = keyof typeof KUMO_CLIPBOARD_TEXT_VARIANTS.size;
24
25
  export interface KumoClipboardTextVariantsProps {
26
+ /**
27
+ * Size of the clipboard text field.
28
+ * - `"sm"` — Small clipboard text for compact UIs
29
+ * - `"base"` — Default clipboard text size
30
+ * - `"lg"` — Large clipboard text for prominent display
31
+ * @default "lg"
32
+ */
25
33
  size?: KumoClipboardTextSize;
26
34
  }
27
35
  export declare function clipboardTextVariants({ size, }?: KumoClipboardTextVariantsProps): string;
28
36
  export type ClipboardTextSize = KumoClipboardTextSize;
37
+ /**
38
+ * ClipboardText component props.
39
+ *
40
+ * @example
41
+ * ```tsx
42
+ * <ClipboardText text="sk_live_abc123" />
43
+ * <ClipboardText text="npm install @cloudflare/kumo" size="sm" />
44
+ * ```
45
+ */
29
46
  export interface ClipboardTextProps extends KumoClipboardTextVariantsProps {
30
- /** The text to display and copy to clipboard */
47
+ /** The text to display and copy to clipboard. */
31
48
  text: string;
32
- /** Additional CSS classes */
49
+ /** Additional CSS classes merged via `cn()`. */
33
50
  className?: string;
34
- /** Callback fired after text is copied */
51
+ /** Callback fired after text is copied to clipboard. */
35
52
  onCopy?: () => void;
36
53
  }
54
+ /**
55
+ * Read-only text field with a one-click copy-to-clipboard button.
56
+ *
57
+ * @example
58
+ * ```tsx
59
+ * <ClipboardText text="0c239dd2" />
60
+ * ```
61
+ */
37
62
  export declare const ClipboardText: import('react').ForwardRefExoticComponent<ClipboardTextProps & import('react').RefAttributes<HTMLDivElement>>;
38
63
  //# sourceMappingURL=clipboard-text.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"clipboard-text.d.ts","sourceRoot":"","sources":["../../../../src/components/clipboard-text/clipboard-text.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;CAkB/B,CAAC;AAEX,eAAO,MAAM,oCAAoC;;CAEvC,CAAC;AAGX,MAAM,MAAM,qBAAqB,GAC/B,MAAM,OAAO,4BAA4B,CAAC,IAAI,CAAC;AAEjD,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAgD,GACjD,GAAE,8BAAmC,UAOrC;AAGD,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,WAAW,kBAAmB,SAAQ,8BAA8B;IACxE,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,+GA6FzB,CAAC"}
1
+ {"version":3,"file":"clipboard-text.d.ts","sourceRoot":"","sources":["../../../../src/components/clipboard-text/clipboard-text.tsx"],"names":[],"mappings":"AAMA,sFAAsF;AACtF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;CAkB/B,CAAC;AAEX,eAAO,MAAM,oCAAoC;;CAEvC,CAAC;AAGX,MAAM,MAAM,qBAAqB,GAC/B,MAAM,OAAO,4BAA4B,CAAC,IAAI,CAAC;AAEjD,MAAM,WAAW,8BAA8B;IAC7C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAgD,GACjD,GAAE,8BAAmC,UAOrC;AAGD,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAmB,SAAQ,8BAA8B;IACxE,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,+GA6FzB,CAAC"}
@@ -0,0 +1,133 @@
1
+ export declare const KUMO_CLOUDFLARE_LOGO_VARIANTS: {
2
+ readonly variant: {
3
+ readonly glyph: {
4
+ readonly description: "Cloud glyph only (logomark)";
5
+ };
6
+ readonly full: {
7
+ readonly description: "Full logo with cloud glyph and wordmark stacked";
8
+ };
9
+ };
10
+ readonly color: {
11
+ readonly color: {
12
+ readonly description: "Brand colors (orange/yellow gradient cloud, dark gray text)";
13
+ };
14
+ readonly black: {
15
+ readonly description: "Solid black logo";
16
+ };
17
+ readonly white: {
18
+ readonly description: "Solid white logo (for dark backgrounds)";
19
+ };
20
+ };
21
+ };
22
+ export declare const KUMO_CLOUDFLARE_LOGO_DEFAULT_VARIANTS: {
23
+ readonly variant: "full";
24
+ readonly color: "color";
25
+ };
26
+ export type CloudflareLogoVariant = keyof typeof KUMO_CLOUDFLARE_LOGO_VARIANTS.variant;
27
+ export type CloudflareLogoColor = keyof typeof KUMO_CLOUDFLARE_LOGO_VARIANTS.color;
28
+ export interface CloudflareLogoProps extends React.SVGAttributes<SVGSVGElement> {
29
+ /**
30
+ * Logo variant
31
+ * - `glyph`: Cloud icon only
32
+ * - `full`: Cloud icon with "CLOUDFLARE" wordmark below
33
+ * @default "full"
34
+ */
35
+ variant?: CloudflareLogoVariant;
36
+ /**
37
+ * Color scheme
38
+ * - `color`: Brand colors (orange/yellow cloud, dark gray wordmark)
39
+ * - `black`: Solid black
40
+ * - `white`: Solid white (for dark backgrounds)
41
+ * @default "color"
42
+ */
43
+ color?: CloudflareLogoColor;
44
+ }
45
+ /**
46
+ * Cloudflare logo component.
47
+ *
48
+ * @example Glyph only (cloud icon)
49
+ * ```tsx
50
+ * <CloudflareLogo variant="glyph" className="w-12" />
51
+ * ```
52
+ *
53
+ * @example Full logo with wordmark
54
+ * ```tsx
55
+ * <CloudflareLogo variant="full" className="w-40" />
56
+ * ```
57
+ *
58
+ * @example White logo for dark backgrounds
59
+ * ```tsx
60
+ * <CloudflareLogo color="white" className="w-32" />
61
+ * ```
62
+ *
63
+ * @example Black logo
64
+ * ```tsx
65
+ * <CloudflareLogo color="black" className="w-32" />
66
+ * ```
67
+ */
68
+ export declare const CloudflareLogo: import('react').ForwardRefExoticComponent<CloudflareLogoProps & import('react').RefAttributes<SVGSVGElement>>;
69
+ export interface PoweredByCloudflareProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
70
+ /**
71
+ * Color scheme for the logo and text
72
+ * @default "color"
73
+ */
74
+ color?: CloudflareLogoColor;
75
+ }
76
+ /**
77
+ * "Powered by Cloudflare" badge component.
78
+ *
79
+ * Renders a link to cloudflare.com with the Cloudflare glyph and "Powered by Cloudflare" text.
80
+ *
81
+ * @example Basic usage
82
+ * ```tsx
83
+ * <PoweredByCloudflare />
84
+ * ```
85
+ *
86
+ * @example White variant for dark backgrounds
87
+ * ```tsx
88
+ * <PoweredByCloudflare color="white" />
89
+ * ```
90
+ *
91
+ * @example Custom link
92
+ * ```tsx
93
+ * <PoweredByCloudflare href="https://cloudflare.com/products/workers" />
94
+ * ```
95
+ */
96
+ export declare const PoweredByCloudflare: import('react').ForwardRefExoticComponent<PoweredByCloudflareProps & import('react').RefAttributes<HTMLAnchorElement>>;
97
+ export type CloudflareLogoSvgVariant = "glyph" | "full";
98
+ export type CloudflareLogoSvgColor = "color" | "black" | "white";
99
+ export interface GenerateCloudflareLogoSvgOptions {
100
+ /**
101
+ * Logo variant
102
+ * - `glyph`: Cloud icon only
103
+ * - `full`: Cloud icon with "CLOUDFLARE" wordmark
104
+ * @default "full"
105
+ */
106
+ variant?: CloudflareLogoSvgVariant;
107
+ /**
108
+ * Color scheme
109
+ * - `color`: Brand colors (orange/yellow cloud, dark gray wordmark)
110
+ * - `black`: Solid black
111
+ * - `white`: Solid white
112
+ * @default "color"
113
+ */
114
+ color?: CloudflareLogoSvgColor;
115
+ }
116
+ /**
117
+ * Generates SVG markup string for the Cloudflare logo.
118
+ *
119
+ * Useful for copying to clipboard or embedding in non-React contexts.
120
+ *
121
+ * @example Copy glyph SVG to clipboard
122
+ * ```tsx
123
+ * const svg = generateCloudflareLogoSvg({ variant: "glyph" });
124
+ * await navigator.clipboard.writeText(svg);
125
+ * ```
126
+ *
127
+ * @example Generate full logo in black
128
+ * ```tsx
129
+ * const svg = generateCloudflareLogoSvg({ variant: "full", color: "black" });
130
+ * ```
131
+ */
132
+ export declare function generateCloudflareLogoSvg(options?: GenerateCloudflareLogoSvgOptions): string;
133
+ //# sourceMappingURL=cloudflare-logo.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloudflare-logo.d.ts","sourceRoot":"","sources":["../../../../src/components/cloudflare-logo/cloudflare-logo.tsx"],"names":[],"mappings":"AAqCA,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;CAqBhC,CAAC;AAEX,eAAO,MAAM,qCAAqC;;;CAGxC,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,MAAM,OAAO,6BAA6B,CAAC,OAAO,CAAC;AACrD,MAAM,MAAM,mBAAmB,GAC7B,MAAM,OAAO,6BAA6B,CAAC,KAAK,CAAC;AAEnD,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc,+GAkF1B,CAAC;AAQF,MAAM,WAAW,wBACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrD;;;OAGG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,wHAsC/B,CAAC;AAQF,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CAuBR"}
@@ -0,0 +1,2 @@
1
+ export { CloudflareLogo, type CloudflareLogoProps, type CloudflareLogoVariant, type CloudflareLogoColor, KUMO_CLOUDFLARE_LOGO_VARIANTS, KUMO_CLOUDFLARE_LOGO_DEFAULT_VARIANTS, PoweredByCloudflare, type PoweredByCloudflareProps, generateCloudflareLogoSvg, type GenerateCloudflareLogoSvgOptions, type CloudflareLogoSvgVariant, type CloudflareLogoSvgColor, } from './cloudflare-logo';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/cloudflare-logo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,6BAA6B,EAC7B,qCAAqC,EAErC,mBAAmB,EACnB,KAAK,wBAAwB,EAE7B,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC"}
@@ -1,4 +1,5 @@
1
1
  import { CSSProperties } from 'react';
2
+ /** Code language variant definitions. */
2
3
  export declare const KUMO_CODE_VARIANTS: {
3
4
  readonly lang: {
4
5
  readonly ts: {
@@ -74,23 +75,43 @@ export declare const KUMO_CODEBLOCK_STYLING: {
74
75
  };
75
76
  export type KumoCodeLang = keyof typeof KUMO_CODE_VARIANTS.lang;
76
77
  export interface KumoCodeVariantsProps {
78
+ /**
79
+ * Language hint for the code content.
80
+ * - `"ts"` — TypeScript code
81
+ * - `"tsx"` — TypeScript JSX code
82
+ * - `"jsonc"` — JSON with comments
83
+ * - `"bash"` — Shell/Bash commands
84
+ * - `"css"` — CSS styles
85
+ * @default "ts"
86
+ */
77
87
  lang?: KumoCodeLang;
78
88
  }
79
89
  export declare function codeVariants({ lang, }?: KumoCodeVariantsProps): string;
80
90
  export type CodeLang = KumoCodeLang;
81
91
  /** @deprecated Use CodeLang instead */
82
92
  export type BundledLanguage = CodeLang;
93
+ /**
94
+ * Code component props.
95
+ *
96
+ * @example
97
+ * ```tsx
98
+ * <Code code="const x = 1;" lang="ts" />
99
+ * <Code code="export API_KEY={{apiKey}}" lang="bash"
100
+ * values={{ apiKey: { value: "sk_live_123", highlight: true } }}
101
+ * />
102
+ * ```
103
+ */
83
104
  export interface CodeProps extends KumoCodeVariantsProps {
84
- /** The code content to display */
105
+ /** The code string to display. */
85
106
  code: string;
86
- /** Template values for interpolation */
107
+ /** Template values for `{{key}}` interpolation. Values with `highlight: true` are visually emphasized. */
87
108
  values?: Record<string, {
88
109
  value: string;
89
110
  highlight?: boolean;
90
111
  }>;
91
- /** Additional CSS classes */
112
+ /** Additional CSS classes merged via `cn()`. */
92
113
  className?: string;
93
- /** Inline styles */
114
+ /** Inline styles. */
94
115
  style?: CSSProperties;
95
116
  }
96
117
  /**
@@ -109,10 +130,21 @@ declare function CodeComponent({ code, lang, className, style, }: CodeProps): im
109
130
  declare namespace CodeComponent {
110
131
  var displayName: string;
111
132
  }
133
+ /**
134
+ * CodeBlock component props — code inside a bordered container.
135
+ *
136
+ * @example
137
+ * ```tsx
138
+ * <CodeBlock lang="tsx" code={`const greeting = "Hello!";`} />
139
+ * ```
140
+ */
112
141
  export interface CodeBlockProps {
113
- /** The code content to display */
142
+ /** The code string to display. */
114
143
  code: string;
115
- /** Language for syntax highlighting metadata */
144
+ /**
145
+ * Language hint for the code content.
146
+ * @default "ts"
147
+ */
116
148
  lang?: CodeLang;
117
149
  }
118
150
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../../src/components/code/code.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAuBrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gCAAgC;;IAEhC,4BAA4B;;;;;;IAM5B,2BAA2B;;;;;;IAM3B,4BAA4B;;;;;;CAMpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,gCAAgC;;IAEhC,wBAAwB;;;;;;;IAOxB,iCAAiC;;IAEjC,wBAAwB;;;;;CAKhB,CAAC;AAGX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAsC,GACvC,GAAE,qBAA0B,UAO5B;AAGD,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEvC,MAAM,WAAW,SAAU,SAAQ,qBAAqB;IACtD,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CACb,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CACF,CAAC;IACF,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,EACrB,IAAI,EACJ,IAAsC,EACtC,SAAS,EACT,KAAK,GACN,EAAE,SAAS,2CAMX;kBAXQ,aAAa;;;AAetB,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,iBAAS,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,cAAc,2CAMzD;kBANQ,kBAAkB;;;AAW3B,eAAO,MAAM,IAAI;;CAEf,CAAC;AAGH,eAAO,MAAM,SAAS,2BAAqB,CAAC"}
1
+ {"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../../src/components/code/code.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,yCAAyC;AACzC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAuBrB,CAAC;AAEX,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,gCAAgC;;IAEhC,4BAA4B;;;;;;IAM5B,2BAA2B;;;;;;IAM3B,4BAA4B;;;;;;CAMpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,gCAAgC;;IAEhC,wBAAwB;;;;;;;IAOxB,iCAAiC;;IAEjC,wBAAwB;;;;;CAKhB,CAAC;AAGX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAsC,GACvC,GAAE,qBAA0B,UAO5B;AAGD,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAU,SAAQ,qBAAqB;IACtD,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,CACb,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CACF,CAAC;IACF,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,EACrB,IAAI,EACJ,IAAsC,EACtC,SAAS,EACT,KAAK,GACN,EAAE,SAAS,2CAMX;kBAXQ,aAAa;;;AAetB;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,iBAAS,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,cAAc,2CAMzD;kBANQ,kBAAkB;;;AAW3B,eAAO,MAAM,IAAI;;CAEf,CAAC;AAGH,eAAO,MAAM,SAAS,2BAAqB,CAAC"}
@@ -4,6 +4,16 @@ export declare const KUMO_COLLAPSIBLE_DEFAULT_VARIANTS: {};
4
4
  export interface KumoCollapsibleVariantsProps {
5
5
  }
6
6
  export declare function collapsibleVariants(_props?: KumoCollapsibleVariantsProps): string;
7
+ /**
8
+ * Collapsible component props.
9
+ *
10
+ * @example
11
+ * ```tsx
12
+ * <Collapsible label="Show details" open={open} onOpenChange={setOpen}>
13
+ * <Text>Hidden content revealed when expanded.</Text>
14
+ * </Collapsible>
15
+ * ```
16
+ */
7
17
  export type CollapsibleProps = PropsWithChildren<KumoCollapsibleVariantsProps & {
8
18
  /** Text label displayed in the trigger button */
9
19
  label: string;
@@ -1 +1 @@
1
- {"version":3,"file":"collapsible.d.ts","sourceRoot":"","sources":["../../../../src/components/collapsible/collapsible.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,OAAO,CAAC;AAG/E,eAAO,MAAM,yBAAyB,IAAc,CAAC;AAErD,eAAO,MAAM,iCAAiC,IAAc,CAAC;AAE7D,MAAM,WAAW,4BAA4B;CAAG;AAEhD,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,4BAAiC,UAK5E;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAC9C,4BAA4B,GAAG;IAC7B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,WAAW;IA5CpB,iDAAiD;WAC1C,MAAM;IACb,iDAAiD;WAC1C,OAAO;IACd,iDAAiD;mBAClC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;IACtC,mDAAmD;gBACvC,MAAM;;;kDAyErB,CAAC"}
1
+ {"version":3,"file":"collapsible.d.ts","sourceRoot":"","sources":["../../../../src/components/collapsible/collapsible.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,OAAO,CAAC;AAG/E,eAAO,MAAM,yBAAyB,IAAc,CAAC;AAErD,eAAO,MAAM,iCAAiC,IAAc,CAAC;AAE7D,MAAM,WAAW,4BAA4B;CAAG;AAEhD,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,4BAAiC,UAK5E;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAC9C,4BAA4B,GAAG;IAC7B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,WAAW;IA5CpB,iDAAiD;WAC1C,MAAM;IACb,iDAAiD;WAC1C,OAAO;IACd,iDAAiD;mBAClC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;IACtC,mDAAmD;gBACvC,MAAM;;;kDAyErB,CAAC"}
@@ -1,6 +1,7 @@
1
1
  import { Combobox as ComboboxBase } from '@base-ui/react/combobox';
2
2
  import { PropsWithChildren, ReactNode } from 'react';
3
3
  import { FieldErrorMatch } from '../field/field';
4
+ /** Combobox input position variant definitions. */
4
5
  export declare const KUMO_COMBOBOX_VARIANTS: {
5
6
  readonly inputSide: {
6
7
  readonly right: {
@@ -18,11 +19,50 @@ export declare const KUMO_COMBOBOX_DEFAULT_VARIANTS: {
18
19
  };
19
20
  export type KumoComboboxInputSide = keyof typeof KUMO_COMBOBOX_VARIANTS.inputSide;
20
21
  export interface KumoComboboxVariantsProps {
22
+ /**
23
+ * Position of the text input relative to chips in multi-select mode.
24
+ * - `"right"` — Input inline to the right of chips
25
+ * - `"top"` — Input above chips
26
+ * @default "right"
27
+ */
21
28
  inputSide?: KumoComboboxInputSide;
22
29
  }
23
30
  export declare function comboboxVariants({ inputSide, }?: KumoComboboxVariantsProps): string;
24
31
  export type ComboboxInputSide = KumoComboboxInputSide;
25
32
  export type ComboboxRootProps<Value = unknown, Multiple extends boolean | undefined = false> = ComboboxBase.Root.Props<Value, Multiple>;
33
+ /**
34
+ * Combobox component props (simplified for documentation; the actual Root is generic).
35
+ *
36
+ * Combobox provides an autocomplete/typeahead input with a filterable dropdown.
37
+ * Supports single-select, multi-select with chips, grouped items, and Field wrapper integration.
38
+ *
39
+ * @example
40
+ * ```tsx
41
+ * // Single-select with search input
42
+ * <Combobox value={value} onValueChange={setValue} items={options}>
43
+ * <Combobox.TriggerInput placeholder="Search…" />
44
+ * <Combobox.Content>
45
+ * <Combobox.List>
46
+ * {(item) => <Combobox.Item value={item}>{item.label}</Combobox.Item>}
47
+ * </Combobox.List>
48
+ * <Combobox.Empty>No results</Combobox.Empty>
49
+ * </Combobox.Content>
50
+ * </Combobox>
51
+ *
52
+ * // Multi-select with chips
53
+ * <Combobox multiple items={options} label="Tags">
54
+ * <Combobox.TriggerMultipleWithInput
55
+ * placeholder="Add tag…"
56
+ * renderItem={(item) => <Combobox.Chip value={item}>{item.label}</Combobox.Chip>}
57
+ * />
58
+ * <Combobox.Content>
59
+ * <Combobox.List>
60
+ * {(item) => <Combobox.Item value={item}>{item.label}</Combobox.Item>}
61
+ * </Combobox.List>
62
+ * </Combobox.Content>
63
+ * </Combobox>
64
+ * ```
65
+ */
26
66
  export interface ComboboxProps extends KumoComboboxVariantsProps {
27
67
  /** Array of items to display in the dropdown */
28
68
  items: unknown[];
@@ -106,6 +146,27 @@ declare function TriggerMultipleWithInput<ValueType>({ placeholder, renderItem,
106
146
  declare namespace TriggerMultipleWithInput {
107
147
  var displayName: string;
108
148
  }
149
+ /**
150
+ * Combobox — autocomplete input with filterable dropdown list.
151
+ *
152
+ * Compound component: `Combobox` (Root), `.TriggerInput`, `.TriggerValue`,
153
+ * `.TriggerMultipleWithInput`, `.Content`, `.Item`, `.Chip`, `.Input`,
154
+ * `.Empty`, `.GroupLabel`, `.Group`, `.List`, `.Collection`.
155
+ *
156
+ * @example
157
+ * ```tsx
158
+ * <Combobox items={fruits} label="Fruit">
159
+ * <Combobox.TriggerInput placeholder="Pick a fruit…" />
160
+ * <Combobox.Content>
161
+ * <Combobox.List>
162
+ * {(item) => <Combobox.Item value={item}>{item}</Combobox.Item>}
163
+ * </Combobox.List>
164
+ * </Combobox.Content>
165
+ * </Combobox>
166
+ * ```
167
+ *
168
+ * @see https://base-ui.com/react/components/combobox
169
+ */
109
170
  export declare const Combobox: typeof Root & {
110
171
  Content: typeof Content;
111
172
  TriggerValue: typeof TriggerValue;
@@ -1 +1 @@
1
- {"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/combobox/combobox.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/combobox/combobox.tsx"],"names":[],"mappings":"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"}
@@ -178,15 +178,50 @@ declare function PanelInput({ autoFocus, placeholder, className, onKeyDown: onKe
178
178
  declare function Results({ children, className, }: React.ComponentProps<typeof Autocomplete.List> & {
179
179
  className?: string;
180
180
  }): import("react/jsx-runtime").JSX.Element;
181
- /**
182
- * CommandPalette variants configuration.
183
- * CommandPalette is a compound component without traditional variants.
184
- */
181
+ /** CommandPalette variant definitions (no user-facing variants; structure reserved for future use). */
185
182
  export declare const KUMO_COMMAND_PALETTE_VARIANTS: {};
183
+ export declare const KUMO_COMMAND_PALETTE_DEFAULT_VARIANTS: {};
186
184
  /**
187
- * CommandPalette default variants.
185
+ * CommandPalette accessible command palette / spotlight search overlay.
186
+ *
187
+ * Compound component: `CommandPalette.Root` (or `.Dialog` + `.Panel`),
188
+ * `.Input`, `.List`, `.Results`, `.Items`, `.Group`, `.GroupLabel`,
189
+ * `.Item`, `.ResultItem`, `.HighlightedText`, `.Empty`, `.Loading`, `.Footer`.
190
+ *
191
+ * Built on `@base-ui/react/autocomplete` + `@base-ui/react/dialog`.
192
+ *
193
+ * @example
194
+ * ```tsx
195
+ * <CommandPalette.Root
196
+ * open={open}
197
+ * onOpenChange={setOpen}
198
+ * items={results}
199
+ * value={query}
200
+ * onValueChange={setQuery}
201
+ * itemToStringValue={(g) => g.label}
202
+ * onSelect={(item, { newTab }) => navigate(item, newTab)}
203
+ * getSelectableItems={(groups) => groups.flatMap((g) => g.items)}
204
+ * >
205
+ * <CommandPalette.Input placeholder="Search…" />
206
+ * <CommandPalette.List>
207
+ * <CommandPalette.Results>
208
+ * {(group) => (
209
+ * <CommandPalette.Group items={group.items}>
210
+ * <CommandPalette.GroupLabel>{group.label}</CommandPalette.GroupLabel>
211
+ * <CommandPalette.Items>
212
+ * {(item) => (
213
+ * <CommandPalette.ResultItem title={item.title} value={item} onClick={…} />
214
+ * )}
215
+ * </CommandPalette.Items>
216
+ * </CommandPalette.Group>
217
+ * )}
218
+ * </CommandPalette.Results>
219
+ * <CommandPalette.Empty>No results found</CommandPalette.Empty>
220
+ * </CommandPalette.List>
221
+ * <CommandPalette.Footer>…keyboard hints…</CommandPalette.Footer>
222
+ * </CommandPalette.Root>
223
+ * ```
188
224
  */
189
- export declare const KUMO_COMMAND_PALETTE_DEFAULT_VARIANTS: {};
190
225
  export declare const CommandPalette: {
191
226
  /** Modal dialog wrapper - use with Panel for content that can swap */
192
227
  Dialog: typeof Dialog;
@@ -1 +1 @@
1
- {"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../../../../src/components/command-palette/command-palette.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../../../../src/components/command-palette/command-palette.tsx"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ /** DateRangePicker size and variant definitions mapping names to their Tailwind classes. */
1
2
  export declare const KUMO_DATE_RANGE_PICKER_VARIANTS: {
2
3
  readonly size: {
3
4
  readonly sm: {
@@ -46,20 +47,72 @@ export declare const KUMO_DATE_RANGE_PICKER_DEFAULT_VARIANTS: {
46
47
  export type KumoDateRangePickerSize = keyof typeof KUMO_DATE_RANGE_PICKER_VARIANTS.size;
47
48
  export type KumoDateRangePickerVariant = keyof typeof KUMO_DATE_RANGE_PICKER_VARIANTS.variant;
48
49
  export interface KumoDateRangePickerVariantsProps {
50
+ /**
51
+ * Calendar size.
52
+ * - `"sm"` — Compact calendar for tight spaces
53
+ * - `"base"` — Default calendar size
54
+ * - `"lg"` — Large calendar for prominent date selection
55
+ * @default "base"
56
+ */
49
57
  size?: KumoDateRangePickerSize;
58
+ /**
59
+ * Visual variant.
60
+ * - `"default"` — Standard appearance with overlay background
61
+ * - `"subtle"` — Minimal background
62
+ * @default "default"
63
+ */
50
64
  variant?: KumoDateRangePickerVariant;
51
65
  }
52
66
  export declare function dateRangePickerVariants({ size, variant, }?: KumoDateRangePickerVariantsProps): string;
67
+ /**
68
+ * DateRangePicker component props.
69
+ *
70
+ * Dual-calendar date range selector with hover preview, timezone display, and reset support.
71
+ *
72
+ * @example
73
+ * ```tsx
74
+ * <DateRangePicker
75
+ * onStartDateChange={(d) => setStart(d)}
76
+ * onEndDateChange={(d) => setEnd(d)}
77
+ * timezone="New York, NY, USA (GMT-4)"
78
+ * />
79
+ *
80
+ * // Compact variant
81
+ * <DateRangePicker
82
+ * size="sm"
83
+ * variant="subtle"
84
+ * onStartDateChange={setStart}
85
+ * onEndDateChange={setEnd}
86
+ * />
87
+ * ```
88
+ */
53
89
  export interface DateRangePickerProps extends KumoDateRangePickerVariantsProps {
54
- /** Callback fired when start date changes */
90
+ /** Callback fired when start date changes. Receives `null` on reset. */
55
91
  onStartDateChange: (date: Date | null) => void;
56
- /** Callback fired when end date changes */
92
+ /** Callback fired when end date changes. Receives `null` on reset. */
57
93
  onEndDateChange: (date: Date | null) => void;
58
- /** Display timezone (display only) */
94
+ /**
95
+ * Display timezone string shown in the footer.
96
+ * @default "New York, NY, USA (GMT-4)"
97
+ */
59
98
  timezone?: string;
60
- /** Additional CSS classes */
99
+ /** Additional CSS classes merged via `cn()`. */
61
100
  className?: string;
62
101
  }
102
+ /**
103
+ * DateRangePicker — dual-calendar date range selector.
104
+ *
105
+ * Renders two side-by-side month calendars with click-to-select start/end dates,
106
+ * hover preview of the range, a timezone footer, and a reset button.
107
+ *
108
+ * @example
109
+ * ```tsx
110
+ * <DateRangePicker
111
+ * onStartDateChange={setStart}
112
+ * onEndDateChange={setEnd}
113
+ * />
114
+ * ```
115
+ */
63
116
  export declare function DateRangePicker({ onStartDateChange, onEndDateChange, size, variant, timezone, className, }: DateRangePickerProps): import("react/jsx-runtime").JSX.Element;
64
117
  export default DateRangePicker;
65
118
  //# sourceMappingURL=date-range-picker.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"date-range-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/date-range-picker/date-range-picker.tsx"],"names":[],"mappings":"AAQA,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwClC,CAAC;AAEX,eAAO,MAAM,uCAAuC;;;CAG1C,CAAC;AAGX,MAAM,MAAM,uBAAuB,GACjC,MAAM,OAAO,+BAA+B,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,0BAA0B,GACpC,MAAM,OAAO,+BAA+B,CAAC,OAAO,CAAC;AAEvD,MAAM,WAAW,gCAAgC;IAC/C,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,wBAAgB,uBAAuB,CAAC,EACtC,IAAmD,EACnD,OAAyD,GAC1D,GAAE,gCAAqC,UAQvC;AAkBD,MAAM,WAAW,oBAAqB,SAAQ,gCAAgC;IAC5E,6CAA6C;IAC7C,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,2CAA2C;IAC3C,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,EAC9B,iBAAiB,EACjB,eAAe,EACf,IAAmD,EACnD,OAAyD,EACzD,QAAsC,EACtC,SAAS,GACV,EAAE,oBAAoB,2CA8TtB;AA+KD,eAAe,eAAe,CAAC"}
1
+ {"version":3,"file":"date-range-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/date-range-picker/date-range-picker.tsx"],"names":[],"mappings":"AAQA,4FAA4F;AAC5F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwClC,CAAC;AAEX,eAAO,MAAM,uCAAuC;;;CAG1C,CAAC;AAGX,MAAM,MAAM,uBAAuB,GACjC,MAAM,OAAO,+BAA+B,CAAC,IAAI,CAAC;AACpD,MAAM,MAAM,0BAA0B,GACpC,MAAM,OAAO,+BAA+B,CAAC,OAAO,CAAC;AAEvD,MAAM,WAAW,gCAAgC;IAC/C;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,wBAAgB,uBAAuB,CAAC,EACtC,IAAmD,EACnD,OAAyD,GAC1D,GAAE,gCAAqC,UAQvC;AAkBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gCAAgC;IAC5E,wEAAwE;IACxE,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,sEAAsE;IACtE,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAC9B,iBAAiB,EACjB,eAAe,EACf,IAAmD,EACnD,OAAyD,EACzD,QAAsC,EACtC,SAAS,GACV,EAAE,oBAAoB,2CA8TtB;AA+KD,eAAe,eAAe,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import { CSSProperties, FC, ReactNode } from 'react';
2
2
  import { Dialog as DialogBase } from '@base-ui/react/dialog';
3
+ /** Dialog size variant definitions mapping sizes to their minimum widths. */
3
4
  export declare const KUMO_DIALOG_VARIANTS: {
4
5
  readonly size: {
5
6
  readonly base: {
@@ -96,12 +97,38 @@ export declare const KUMO_DIALOG_STYLING: {
96
97
  };
97
98
  export type KumoDialogSize = keyof typeof KUMO_DIALOG_VARIANTS.size;
98
99
  export interface KumoDialogVariantsProps {
100
+ /**
101
+ * Dialog width.
102
+ * - `"sm"` — Small (min 288px) for simple confirmations
103
+ * - `"base"` — Default (min 384px)
104
+ * - `"lg"` — Large (min 512px) for complex content
105
+ * - `"xl"` — Extra large (min 768px) for detailed views
106
+ * @default "base"
107
+ */
99
108
  size?: KumoDialogSize;
100
109
  }
101
110
  export declare function dialogVariants({ size, }?: KumoDialogVariantsProps): string;
111
+ /**
112
+ * Dialog component props — the modal content panel.
113
+ *
114
+ * @example
115
+ * ```tsx
116
+ * <Dialog.Root>
117
+ * <Dialog.Trigger render={(p) => <Button {...p}>Open</Button>} />
118
+ * <Dialog className="p-8">
119
+ * <Dialog.Title>Confirm Action</Dialog.Title>
120
+ * <Dialog.Description>Are you sure?</Dialog.Description>
121
+ * <Dialog.Close render={(p) => <Button {...p}>Cancel</Button>} />
122
+ * </Dialog>
123
+ * </Dialog.Root>
124
+ * ```
125
+ */
102
126
  export type DialogProps = KumoDialogVariantsProps & {
127
+ /** Additional CSS classes merged via `cn()`. */
103
128
  className?: string;
129
+ /** Dialog content (typically Title, Description, Close, and action buttons). */
104
130
  children: ReactNode;
131
+ /** Inline styles. */
105
132
  style?: CSSProperties;
106
133
  };
107
134
  type DialogComponent = FC<DialogProps> & {
@@ -1 +1 @@
1
- {"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAmBvB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDtB,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,UAO9B;AAED,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AA+BF,KAAK,eAAe,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG;IACvC,IAAI,EAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IAC3C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,MAAM,EAMN,eAAe,CAAC;AAEtB,QAAA,MAAM,UAAU,wBAAc,CAAC;AAC/B,QAAA,MAAM,aAAa,oBAAiB,CAAC;AACrC,QAAA,MAAM,WAAW,mJAAe,CAAC;AACjC,QAAA,MAAM,iBAAiB,yJAAqB,CAAC;AAC7C,QAAA,MAAM,WAAW,gJAAe,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,CAAC"}
1
+ {"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../src/components/dialog/dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI7D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAmBvB,CAAC;AAEX,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDtB,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,oBAAoB,CAAC,IAAI,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAwC,GACzC,GAAE,uBAA4B,UAO9B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAClD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,SAAS,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AA+CF,KAAK,eAAe,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG;IACvC,IAAI,EAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC/B,WAAW,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC;IAC3C,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,MAAM,EAMN,eAAe,CAAC;AAEtB,QAAA,MAAM,UAAU,wBAAc,CAAC;AAC/B,QAAA,MAAM,aAAa,oBAAiB,CAAC;AACrC,QAAA,MAAM,WAAW,mJAAe,CAAC;AACjC,QAAA,MAAM,iBAAiB,yJAAqB,CAAC;AAC7C,QAAA,MAAM,WAAW,gJAAe,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,GACZ,CAAC"}