@kjun-ui/react 0.17.0 → 0.19.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 (156) hide show
  1. package/dist/index.cjs +4267 -1765
  2. package/dist/index.js +4272 -1767
  3. package/dist/styles.css +1612 -577
  4. package/dist/types/packages/react/src/actions.d.cts +12 -3
  5. package/dist/types/packages/react/src/actions.d.ts +12 -3
  6. package/dist/types/packages/react/src/app-navigation.d.cts +31 -8
  7. package/dist/types/packages/react/src/app-navigation.d.ts +31 -8
  8. package/dist/types/packages/react/src/calendar.d.cts +30 -0
  9. package/dist/types/packages/react/src/calendar.d.ts +30 -0
  10. package/dist/types/packages/react/src/carousel.d.cts +39 -0
  11. package/dist/types/packages/react/src/carousel.d.ts +39 -0
  12. package/dist/types/packages/react/src/controls.d.cts +16 -11
  13. package/dist/types/packages/react/src/controls.d.ts +16 -11
  14. package/dist/types/packages/react/src/date-picker.d.cts +34 -6
  15. package/dist/types/packages/react/src/date-picker.d.ts +34 -6
  16. package/dist/types/packages/react/src/display.d.cts +15 -3
  17. package/dist/types/packages/react/src/display.d.ts +15 -3
  18. package/dist/types/packages/react/src/drawer.d.cts +3 -5
  19. package/dist/types/packages/react/src/drawer.d.ts +3 -5
  20. package/dist/types/packages/react/src/dropdown.d.cts +35 -3
  21. package/dist/types/packages/react/src/dropdown.d.ts +35 -3
  22. package/dist/types/packages/react/src/fab.d.cts +3 -3
  23. package/dist/types/packages/react/src/fab.d.ts +3 -3
  24. package/dist/types/packages/react/src/feedback.d.cts +12 -3
  25. package/dist/types/packages/react/src/feedback.d.ts +12 -3
  26. package/dist/types/packages/react/src/financial-display.d.cts +10 -1
  27. package/dist/types/packages/react/src/financial-display.d.ts +10 -1
  28. package/dist/types/packages/react/src/financial.d.cts +2 -2
  29. package/dist/types/packages/react/src/financial.d.ts +2 -2
  30. package/dist/types/packages/react/src/index.d.cts +10 -6
  31. package/dist/types/packages/react/src/index.d.ts +10 -6
  32. package/dist/types/packages/react/src/layers.d.cts +1 -1
  33. package/dist/types/packages/react/src/layers.d.ts +1 -1
  34. package/dist/types/packages/react/src/layout-primitives.d.cts +24 -24
  35. package/dist/types/packages/react/src/layout-primitives.d.ts +24 -24
  36. package/dist/types/packages/react/src/list.d.cts +27 -4
  37. package/dist/types/packages/react/src/list.d.ts +27 -4
  38. package/dist/types/packages/react/src/market-model.d.cts +8 -1
  39. package/dist/types/packages/react/src/market-model.d.ts +8 -1
  40. package/dist/types/packages/react/src/modal.d.cts +3 -1
  41. package/dist/types/packages/react/src/modal.d.ts +3 -1
  42. package/dist/types/packages/react/src/navigation.d.cts +24 -42
  43. package/dist/types/packages/react/src/navigation.d.ts +24 -42
  44. package/dist/types/packages/react/src/number-display.d.cts +12 -12
  45. package/dist/types/packages/react/src/number-display.d.ts +12 -12
  46. package/dist/types/packages/react/src/popover.d.cts +9 -4
  47. package/dist/types/packages/react/src/popover.d.ts +9 -4
  48. package/dist/types/packages/react/src/provider.d.cts +4 -1
  49. package/dist/types/packages/react/src/provider.d.ts +4 -1
  50. package/dist/types/packages/react/src/select-control.d.cts +3 -1
  51. package/dist/types/packages/react/src/select-control.d.ts +3 -1
  52. package/dist/types/packages/react/src/select.d.cts +2 -2
  53. package/dist/types/packages/react/src/select.d.ts +2 -2
  54. package/dist/types/packages/react/src/skeleton-phase.d.cts +2 -0
  55. package/dist/types/packages/react/src/skeleton-phase.d.ts +2 -0
  56. package/dist/types/packages/react/src/skeletons.d.cts +19 -4
  57. package/dist/types/packages/react/src/skeletons.d.ts +19 -4
  58. package/dist/types/packages/react/src/table-cards.d.cts +6 -3
  59. package/dist/types/packages/react/src/table-cards.d.ts +6 -3
  60. package/dist/types/packages/react/src/table-grid.d.cts +1 -1
  61. package/dist/types/packages/react/src/table-grid.d.ts +1 -1
  62. package/dist/types/packages/react/src/table-list.d.cts +10 -0
  63. package/dist/types/packages/react/src/table-list.d.ts +10 -0
  64. package/dist/types/packages/react/src/table-model.d.cts +2 -0
  65. package/dist/types/packages/react/src/table-model.d.ts +2 -0
  66. package/dist/types/packages/react/src/table-toolbar.d.cts +1 -1
  67. package/dist/types/packages/react/src/table-toolbar.d.ts +1 -1
  68. package/dist/types/packages/react/src/table-totals.d.cts +5 -0
  69. package/dist/types/packages/react/src/table-totals.d.ts +5 -0
  70. package/dist/types/packages/react/src/tabs.d.cts +38 -0
  71. package/dist/types/packages/react/src/tabs.d.ts +38 -0
  72. package/dist/types/packages/react/src/textarea.d.cts +29 -0
  73. package/dist/types/packages/react/src/textarea.d.ts +29 -0
  74. package/dist/types/packages/react/src/time-picker.d.cts +10 -1
  75. package/dist/types/packages/react/src/time-picker.d.ts +10 -1
  76. package/dist/types/packages/react/src/toast-stack.d.cts +7 -2
  77. package/dist/types/packages/react/src/toast-stack.d.ts +7 -2
  78. package/dist/types/shared/package-runtime/accordion-state.d.cts +11 -0
  79. package/dist/types/shared/package-runtime/accordion-state.d.ts +11 -0
  80. package/dist/types/shared/package-runtime/action-size.d.cts +1 -1
  81. package/dist/types/shared/package-runtime/action-size.d.ts +1 -1
  82. package/dist/types/shared/package-runtime/alert-action-size.d.cts +2 -0
  83. package/dist/types/shared/package-runtime/alert-action-size.d.ts +2 -0
  84. package/dist/types/shared/package-runtime/badge-tone.d.cts +59 -0
  85. package/dist/types/shared/package-runtime/badge-tone.d.ts +59 -0
  86. package/dist/types/shared/package-runtime/breadcrumb.d.cts +20 -0
  87. package/dist/types/shared/package-runtime/breadcrumb.d.ts +20 -0
  88. package/dist/types/shared/package-runtime/calendar.d.cts +106 -0
  89. package/dist/types/shared/package-runtime/calendar.d.ts +106 -0
  90. package/dist/types/shared/package-runtime/carousel-scroll.d.cts +22 -0
  91. package/dist/types/shared/package-runtime/carousel-scroll.d.ts +22 -0
  92. package/dist/types/shared/package-runtime/carousel.d.cts +47 -0
  93. package/dist/types/shared/package-runtime/carousel.d.ts +47 -0
  94. package/dist/types/shared/package-runtime/center-option.d.cts +1 -0
  95. package/dist/types/shared/package-runtime/center-option.d.ts +1 -0
  96. package/dist/types/shared/package-runtime/chart-skeleton.d.cts +15 -3
  97. package/dist/types/shared/package-runtime/chart-skeleton.d.ts +15 -3
  98. package/dist/types/shared/package-runtime/drawer-geometry.d.cts +2 -3
  99. package/dist/types/shared/package-runtime/drawer-geometry.d.ts +2 -3
  100. package/dist/types/shared/package-runtime/feedback-dialog.d.cts +5 -4
  101. package/dist/types/shared/package-runtime/feedback-dialog.d.ts +5 -4
  102. package/dist/types/shared/package-runtime/feedback-motion.d.cts +2 -5
  103. package/dist/types/shared/package-runtime/feedback-motion.d.ts +2 -5
  104. package/dist/types/shared/package-runtime/feedback-prompt.d.cts +58 -0
  105. package/dist/types/shared/package-runtime/feedback-prompt.d.ts +58 -0
  106. package/dist/types/shared/package-runtime/list-row.d.cts +14 -0
  107. package/dist/types/shared/package-runtime/list-row.d.ts +14 -0
  108. package/dist/types/shared/package-runtime/market-layout.d.cts +0 -1
  109. package/dist/types/shared/package-runtime/market-layout.d.ts +0 -1
  110. package/dist/types/shared/package-runtime/messages/ko.d.cts +45 -5
  111. package/dist/types/shared/package-runtime/messages/ko.d.ts +45 -5
  112. package/dist/types/shared/package-runtime/messages-context.d.cts +45 -5
  113. package/dist/types/shared/package-runtime/messages-context.d.ts +45 -5
  114. package/dist/types/shared/package-runtime/navigation-badge.d.cts +12 -0
  115. package/dist/types/shared/package-runtime/navigation-badge.d.ts +12 -0
  116. package/dist/types/shared/package-runtime/navigation.d.cts +1 -1
  117. package/dist/types/shared/package-runtime/navigation.d.ts +1 -1
  118. package/dist/types/shared/package-runtime/safe-area.d.cts +20 -0
  119. package/dist/types/shared/package-runtime/safe-area.d.ts +20 -0
  120. package/dist/types/shared/package-runtime/scroll-fade.d.cts +25 -0
  121. package/dist/types/shared/package-runtime/scroll-fade.d.ts +25 -0
  122. package/dist/types/shared/package-runtime/skeleton-text.d.cts +12 -0
  123. package/dist/types/shared/package-runtime/skeleton-text.d.ts +12 -0
  124. package/dist/types/shared/package-runtime/sparkline.d.cts +58 -0
  125. package/dist/types/shared/package-runtime/sparkline.d.ts +58 -0
  126. package/dist/types/shared/package-runtime/stable-value.d.cts +3 -0
  127. package/dist/types/shared/package-runtime/stable-value.d.ts +3 -0
  128. package/dist/types/shared/package-runtime/table-groups.d.cts +11 -0
  129. package/dist/types/shared/package-runtime/table-groups.d.ts +11 -0
  130. package/dist/types/shared/package-runtime/table-model.d.cts +25 -2
  131. package/dist/types/shared/package-runtime/table-model.d.ts +25 -2
  132. package/dist/types/shared/package-runtime/table-presentation.d.cts +67 -5
  133. package/dist/types/shared/package-runtime/table-presentation.d.ts +67 -5
  134. package/dist/types/shared/package-runtime/table.d.cts +24 -2
  135. package/dist/types/shared/package-runtime/table.d.ts +24 -2
  136. package/dist/types/shared/package-runtime/textarea-grow.d.cts +1 -0
  137. package/dist/types/shared/package-runtime/textarea-grow.d.ts +1 -0
  138. package/dist/types/shared/package-runtime/textarea.d.cts +53 -0
  139. package/dist/types/shared/package-runtime/textarea.d.ts +53 -0
  140. package/dist/types/shared/package-runtime/time-segments.d.cts +25 -0
  141. package/dist/types/shared/package-runtime/time-segments.d.ts +25 -0
  142. package/dist/types/shared/package-runtime/toast-entry.d.cts +3 -0
  143. package/dist/types/shared/package-runtime/toast-entry.d.ts +3 -0
  144. package/dist/types/shared/package-runtime/toast-placement.d.cts +4 -0
  145. package/dist/types/shared/package-runtime/toast-placement.d.ts +4 -0
  146. package/dist/types/shared/package-runtime/toast-presence.d.cts +12 -0
  147. package/dist/types/shared/package-runtime/toast-presence.d.ts +12 -0
  148. package/dist/types/shared/package-runtime/toast-presentation.d.cts +42 -0
  149. package/dist/types/shared/package-runtime/toast-presentation.d.ts +42 -0
  150. package/dist/types/shared/package-runtime/toast-swipe.d.cts +20 -0
  151. package/dist/types/shared/package-runtime/toast-swipe.d.ts +20 -0
  152. package/dist/types/shared/package-runtime/use-toast-stack.d.cts +22 -0
  153. package/dist/types/shared/package-runtime/use-toast-stack.d.ts +22 -0
  154. package/package.json +3 -3
  155. package/dist/types/shared/package-runtime/relative-time.d.cts +0 -1
  156. package/dist/types/shared/package-runtime/relative-time.d.ts +0 -1
@@ -6,15 +6,19 @@ export interface KjunPopoverProps {
6
6
  onOpenChange?: (v: boolean) => void;
7
7
  manualTrigger?: boolean;
8
8
  matchTriggerWidth?: boolean;
9
+ /** Width step (popover.widths): sm 192, md 240 (default), lg 320. matchTriggerWidth takes the trigger's width instead. */
10
+ width?: "sm" | "md" | "lg";
9
11
  maxHeight?: CSSProperties["maxHeight"];
10
12
  flip?: boolean;
11
13
  focusOnOpen?: boolean;
12
14
  ariaLabel?: string;
13
- placement?: "top" | "bottom" | "left" | "right";
15
+ /** A side, or a side with an aligned edge: "bottom-start" lines the panel up with the trigger's start edge. */
16
+ placement?: PopoverPlacement;
14
17
  /** Where focus goes when the Popover closes. Defaults to the trigger, also when the target is gone. */
15
18
  returnFocus?: HTMLElement | RefObject<HTMLElement | null> | (() => HTMLElement | null);
16
- /** Fixed header above the body; only the body scrolls and maxHeight covers both. Names the dialog without ariaLabel. */
17
- header?: ReactNode;
19
+ /** Fixed header above the body; only the body scrolls and maxHeight covers both. Names the dialog without ariaLabel.
20
+ * A function receives close, for a close button in the header. */
21
+ header?: ReactNode | ((close: () => void) => ReactNode);
18
22
  /** false keeps the page usable: Tab can leave, and an outside press or focus move closes without returning focus. */
19
23
  modal?: boolean;
20
24
  /** Attach to this screen rectangle (or a function read every frame while open) instead of the trigger. Web only.
@@ -23,7 +27,8 @@ export interface KjunPopoverProps {
23
27
  trigger?: ReactNode | ((open: boolean) => ReactNode);
24
28
  children: ReactNode | ((close: () => void) => ReactNode);
25
29
  }
26
- export declare function KjunPopover({ noPadding, open: controlled, onOpenChange, manualTrigger, matchTriggerWidth, maxHeight, flip, focusOnOpen, ariaLabel, placement, returnFocus, header, modal, anchorRect, trigger, children, }: KjunPopoverProps): import("react/jsx-runtime").JSX.Element;
30
+ export type PopoverPlacement = "top" | "bottom" | "left" | "right" | "top-start" | "top-end" | "bottom-start" | "bottom-end";
31
+ export declare function KjunPopover({ noPadding, open: controlled, onOpenChange, manualTrigger, matchTriggerWidth, width, maxHeight, flip, focusOnOpen, ariaLabel, placement, returnFocus, header, modal, anchorRect, trigger, children, }: KjunPopoverProps): import("react/jsx-runtime").JSX.Element;
27
32
  export interface KjunTooltipProps {
28
33
  content?: string;
29
34
  /** A bolder line above content (a file name above its path). Read together with content. */
@@ -6,15 +6,19 @@ export interface KjunPopoverProps {
6
6
  onOpenChange?: (v: boolean) => void;
7
7
  manualTrigger?: boolean;
8
8
  matchTriggerWidth?: boolean;
9
+ /** Width step (popover.widths): sm 192, md 240 (default), lg 320. matchTriggerWidth takes the trigger's width instead. */
10
+ width?: "sm" | "md" | "lg";
9
11
  maxHeight?: CSSProperties["maxHeight"];
10
12
  flip?: boolean;
11
13
  focusOnOpen?: boolean;
12
14
  ariaLabel?: string;
13
- placement?: "top" | "bottom" | "left" | "right";
15
+ /** A side, or a side with an aligned edge: "bottom-start" lines the panel up with the trigger's start edge. */
16
+ placement?: PopoverPlacement;
14
17
  /** Where focus goes when the Popover closes. Defaults to the trigger, also when the target is gone. */
15
18
  returnFocus?: HTMLElement | RefObject<HTMLElement | null> | (() => HTMLElement | null);
16
- /** Fixed header above the body; only the body scrolls and maxHeight covers both. Names the dialog without ariaLabel. */
17
- header?: ReactNode;
19
+ /** Fixed header above the body; only the body scrolls and maxHeight covers both. Names the dialog without ariaLabel.
20
+ * A function receives close, for a close button in the header. */
21
+ header?: ReactNode | ((close: () => void) => ReactNode);
18
22
  /** false keeps the page usable: Tab can leave, and an outside press or focus move closes without returning focus. */
19
23
  modal?: boolean;
20
24
  /** Attach to this screen rectangle (or a function read every frame while open) instead of the trigger. Web only.
@@ -23,7 +27,8 @@ export interface KjunPopoverProps {
23
27
  trigger?: ReactNode | ((open: boolean) => ReactNode);
24
28
  children: ReactNode | ((close: () => void) => ReactNode);
25
29
  }
26
- export declare function KjunPopover({ noPadding, open: controlled, onOpenChange, manualTrigger, matchTriggerWidth, maxHeight, flip, focusOnOpen, ariaLabel, placement, returnFocus, header, modal, anchorRect, trigger, children, }: KjunPopoverProps): import("react/jsx-runtime").JSX.Element;
30
+ export type PopoverPlacement = "top" | "bottom" | "left" | "right" | "top-start" | "top-end" | "bottom-start" | "bottom-end";
31
+ export declare function KjunPopover({ noPadding, open: controlled, onOpenChange, manualTrigger, matchTriggerWidth, width, maxHeight, flip, focusOnOpen, ariaLabel, placement, returnFocus, header, modal, anchorRect, trigger, children, }: KjunPopoverProps): import("react/jsx-runtime").JSX.Element;
27
32
  export interface KjunTooltipProps {
28
33
  content?: string;
29
34
  /** A bolder line above content (a file name above its path). Read together with content. */
@@ -1,5 +1,6 @@
1
1
  import { type KjunMessages } from "../../../shared/package-runtime/messages/index.cjs";
2
2
  import type { KjunIconRegistry } from "@kjun-ui/icons";
3
+ import { type KjunSafeArea } from "../../../shared/package-runtime/safe-area.cjs";
3
4
  import { type HTMLAttributes, type ReactNode } from "react";
4
5
  export declare const useKjunPortalContainer: () => HTMLElement | null | undefined;
5
6
  export interface KjunProviderProps extends HTMLAttributes<HTMLDivElement> {
@@ -9,5 +10,7 @@ export interface KjunProviderProps extends HTMLAttributes<HTMLDivElement> {
9
10
  locale?: string;
10
11
  /** Replaces part of KJUN's copy, e.g. with the app's own translations. */
11
12
  messages?: Partial<KjunMessages>;
13
+ /** Screen insets in px for toasts, modals, menus and edge components; without it the browser's env(safe-area-inset-*) applies. */
14
+ safeArea?: KjunSafeArea;
12
15
  }
13
- export declare function KjunProvider({ icons, locale, messages, children, className, ...props }: KjunProviderProps): import("react/jsx-runtime").JSX.Element;
16
+ export declare function KjunProvider({ icons, locale, messages, children, className, safeArea, style, ...props }: KjunProviderProps): import("react/jsx-runtime").JSX.Element;
@@ -1,5 +1,6 @@
1
1
  import { type KjunMessages } from "../../../shared/package-runtime/messages/index.js";
2
2
  import type { KjunIconRegistry } from "@kjun-ui/icons";
3
+ import { type KjunSafeArea } from "../../../shared/package-runtime/safe-area.js";
3
4
  import { type HTMLAttributes, type ReactNode } from "react";
4
5
  export declare const useKjunPortalContainer: () => HTMLElement | null | undefined;
5
6
  export interface KjunProviderProps extends HTMLAttributes<HTMLDivElement> {
@@ -9,5 +10,7 @@ export interface KjunProviderProps extends HTMLAttributes<HTMLDivElement> {
9
10
  locale?: string;
10
11
  /** Replaces part of KJUN's copy, e.g. with the app's own translations. */
11
12
  messages?: Partial<KjunMessages>;
13
+ /** Screen insets in px for toasts, modals, menus and edge components; without it the browser's env(safe-area-inset-*) applies. */
14
+ safeArea?: KjunSafeArea;
12
15
  }
13
- export declare function KjunProvider({ icons, locale, messages, children, className, ...props }: KjunProviderProps): import("react/jsx-runtime").JSX.Element;
16
+ export declare function KjunProvider({ icons, locale, messages, children, className, safeArea, style, ...props }: KjunProviderProps): import("react/jsx-runtime").JSX.Element;
@@ -15,6 +15,8 @@ export interface KjunSelectProps<T extends SelectOption = SelectOption> {
15
15
  valueKey?: string;
16
16
  size?: InputSize;
17
17
  disabled?: boolean;
18
+ /** Shows the value without opening the list or clearing it. */
19
+ readOnly?: boolean;
18
20
  searchable?: boolean;
19
21
  open?: boolean;
20
22
  loading?: boolean;
@@ -38,4 +40,4 @@ export interface KjunSelectProps<T extends SelectOption = SelectOption> {
38
40
  /** Where focus goes when the menu closes by choosing or Escape, instead of the trigger (e.g. an edited cell). Web only. */
39
41
  returnFocus?: FocusReturn;
40
42
  }
41
- export declare function KjunSelect<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, id: triggerId, ariaDescribedBy, valueKey, size, disabled, searchable, open: controlled, loading, searchPlaceholder, optionPageSize, clearable, multiple, error, menuHeader, renderOption, renderSelected, onValueChange, onChange, onOpenChange, onSearch, onClear, filterFn, searchKeys, returnFocus, }: KjunSelectProps<T>): import("react/jsx-runtime").JSX.Element;
43
+ export declare function KjunSelect<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, id: triggerId, ariaDescribedBy, valueKey, size, disabled, readOnly, searchable, open: controlled, loading, searchPlaceholder, optionPageSize, clearable, multiple, error, menuHeader, renderOption, renderSelected, onValueChange, onChange, onOpenChange, onSearch, onClear, filterFn, searchKeys, returnFocus, }: KjunSelectProps<T>): import("react/jsx-runtime").JSX.Element;
@@ -15,6 +15,8 @@ export interface KjunSelectProps<T extends SelectOption = SelectOption> {
15
15
  valueKey?: string;
16
16
  size?: InputSize;
17
17
  disabled?: boolean;
18
+ /** Shows the value without opening the list or clearing it. */
19
+ readOnly?: boolean;
18
20
  searchable?: boolean;
19
21
  open?: boolean;
20
22
  loading?: boolean;
@@ -38,4 +40,4 @@ export interface KjunSelectProps<T extends SelectOption = SelectOption> {
38
40
  /** Where focus goes when the menu closes by choosing or Escape, instead of the trigger (e.g. an edited cell). Web only. */
39
41
  returnFocus?: FocusReturn;
40
42
  }
41
- export declare function KjunSelect<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, id: triggerId, ariaDescribedBy, valueKey, size, disabled, searchable, open: controlled, loading, searchPlaceholder, optionPageSize, clearable, multiple, error, menuHeader, renderOption, renderSelected, onValueChange, onChange, onOpenChange, onSearch, onClear, filterFn, searchKeys, returnFocus, }: KjunSelectProps<T>): import("react/jsx-runtime").JSX.Element;
43
+ export declare function KjunSelect<T extends SelectOption = SelectOption>({ value, options, placeholder, ariaLabel, labelKey, id: triggerId, ariaDescribedBy, valueKey, size, disabled, readOnly, searchable, open: controlled, loading, searchPlaceholder, optionPageSize, clearable, multiple, error, menuHeader, renderOption, renderSelected, onValueChange, onChange, onOpenChange, onSearch, onClear, filterFn, searchKeys, returnFocus, }: KjunSelectProps<T>): import("react/jsx-runtime").JSX.Element;
@@ -1,7 +1,7 @@
1
1
  export { KjunCombobox } from "./combobox.cjs";
2
2
  export type { KjunComboboxProps } from "./combobox.cjs";
3
- export { KjunDatePicker } from "./date-picker.cjs";
4
- export type { KjunDatePickerProps } from "./date-picker.cjs";
3
+ export { KjunDatePicker, KjunDateRangePicker } from "./date-picker.cjs";
4
+ export type { KjunDatePickerProps, KjunDateRangePickerProps, DateRange, DateRangePreset } from "./date-picker.cjs";
5
5
  export { KjunSearchInput } from "./search-input.cjs";
6
6
  export type { KjunSearchInputProps } from "./search-input.cjs";
7
7
  export { KjunSelect } from "./select-control.cjs";
@@ -1,7 +1,7 @@
1
1
  export { KjunCombobox } from "./combobox.js";
2
2
  export type { KjunComboboxProps } from "./combobox.js";
3
- export { KjunDatePicker } from "./date-picker.js";
4
- export type { KjunDatePickerProps } from "./date-picker.js";
3
+ export { KjunDatePicker, KjunDateRangePicker } from "./date-picker.js";
4
+ export type { KjunDatePickerProps, KjunDateRangePickerProps, DateRange, DateRangePreset } from "./date-picker.js";
5
5
  export { KjunSearchInput } from "./search-input.js";
6
6
  export type { KjunSearchInputProps } from "./search-input.js";
7
7
  export { KjunSelect } from "./select-control.js";
@@ -0,0 +1,2 @@
1
+ /** Puts a skeleton on the shared pulse clock once it mounts, so skeletons that appear later still pulse together. */
2
+ export declare function useSkeletonPhase(active?: boolean): import("react").RefObject<HTMLDivElement | null>;
@@ -0,0 +1,2 @@
1
+ /** Puts a skeleton on the shared pulse clock once it mounts, so skeletons that appear later still pulse together. */
2
+ export declare function useSkeletonPhase(active?: boolean): import("react").RefObject<HTMLDivElement | null>;
@@ -3,12 +3,19 @@ import { type CSSProperties } from "react";
3
3
  import { type KjunChartSkeletonKind } from "../../../shared/package-runtime/chart-skeleton.cjs";
4
4
  export interface KjunListSkeletonProps {
5
5
  rows?: number;
6
- variant?: "market" | "compact" | "notification";
6
+ /** "row" is the silhouette of KjunListRow: title and description lines, a text-start divider, no avatar unless asked. */
7
+ variant?: "market" | "compact" | "notification" | "row";
7
8
  avatar?: boolean;
8
9
  avatarSize?: CSSProperties["width"];
9
10
  quote?: boolean;
11
+ /** Row variant: draws the description line (default true). */
12
+ description?: boolean;
13
+ /** Row variant: what ends the row, a value (default), a switch or a chevron; quote={false} leaves it empty. */
14
+ trailing?: "value" | "switch" | "chevron";
15
+ /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
16
+ loadingText?: string;
10
17
  }
11
- export declare function KjunListSkeleton({ rows, variant, avatar, avatarSize, quote, }: KjunListSkeletonProps): import("react/jsx-runtime").JSX.Element;
18
+ export declare function KjunListSkeleton({ rows, variant, avatar, avatarSize, quote, description, trailing, loadingText, }: KjunListSkeletonProps): import("react/jsx-runtime").JSX.Element;
12
19
  export interface KjunFormSkeletonProps {
13
20
  fields?: (string | {
14
21
  label?: string;
@@ -17,8 +24,10 @@ export interface KjunFormSkeletonProps {
17
24
  columns?: number;
18
25
  multiline?: boolean;
19
26
  size?: InputSize;
27
+ /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
28
+ loadingText?: string;
20
29
  }
21
- export declare function KjunFormSkeleton({ fields, columns, multiline, size, }: KjunFormSkeletonProps): import("react/jsx-runtime").JSX.Element;
30
+ export declare function KjunFormSkeleton({ fields, columns, multiline, size, loadingText, }: KjunFormSkeletonProps): import("react/jsx-runtime").JSX.Element;
22
31
  export interface KjunChartSkeletonProps {
23
32
  kind?: KjunChartSkeletonKind;
24
33
  height?: CSSProperties["height"];
@@ -27,7 +36,13 @@ export interface KjunChartSkeletonProps {
27
36
  loadingDelay?: number;
28
37
  rows?: number;
29
38
  columns?: number;
39
+ /** Frame: horizontal grid lines of the app's chart, top to baseline (default 5). */
40
+ gridLines?: number;
41
+ /** Frame: x-axis tick labels (default 6). */
42
+ xTicks?: number;
43
+ /** Frame: y-axis label width in px (default 40); label bars fill it, less the label gap. */
44
+ axisWidth?: number;
30
45
  }
31
- export declare function KjunChartSkeleton({ kind: requestedKind, height, loadingText, skeleton, loadingDelay, rows, columns, }: KjunChartSkeletonProps): import("react/jsx-runtime").JSX.Element;
46
+ export declare function KjunChartSkeleton({ kind: requestedKind, height, loadingText, skeleton, loadingDelay, rows, columns, gridLines, xTicks, axisWidth, }: KjunChartSkeletonProps): import("react/jsx-runtime").JSX.Element;
32
47
  export { KjunMarketTableSkeleton } from "./market-skeleton.cjs";
33
48
  export type { KjunMarketTableSkeletonProps } from "./market-skeleton.cjs";
@@ -3,12 +3,19 @@ import { type CSSProperties } from "react";
3
3
  import { type KjunChartSkeletonKind } from "../../../shared/package-runtime/chart-skeleton.js";
4
4
  export interface KjunListSkeletonProps {
5
5
  rows?: number;
6
- variant?: "market" | "compact" | "notification";
6
+ /** "row" is the silhouette of KjunListRow: title and description lines, a text-start divider, no avatar unless asked. */
7
+ variant?: "market" | "compact" | "notification" | "row";
7
8
  avatar?: boolean;
8
9
  avatarSize?: CSSProperties["width"];
9
10
  quote?: boolean;
11
+ /** Row variant: draws the description line (default true). */
12
+ description?: boolean;
13
+ /** Row variant: what ends the row, a value (default), a switch or a chevron; quote={false} leaves it empty. */
14
+ trailing?: "value" | "switch" | "chevron";
15
+ /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
16
+ loadingText?: string;
10
17
  }
11
- export declare function KjunListSkeleton({ rows, variant, avatar, avatarSize, quote, }: KjunListSkeletonProps): import("react/jsx-runtime").JSX.Element;
18
+ export declare function KjunListSkeleton({ rows, variant, avatar, avatarSize, quote, description, trailing, loadingText, }: KjunListSkeletonProps): import("react/jsx-runtime").JSX.Element;
12
19
  export interface KjunFormSkeletonProps {
13
20
  fields?: (string | {
14
21
  label?: string;
@@ -17,8 +24,10 @@ export interface KjunFormSkeletonProps {
17
24
  columns?: number;
18
25
  multiline?: boolean;
19
26
  size?: InputSize;
27
+ /** Announces loading to screen readers (a status); the skeleton itself stays silent. */
28
+ loadingText?: string;
20
29
  }
21
- export declare function KjunFormSkeleton({ fields, columns, multiline, size, }: KjunFormSkeletonProps): import("react/jsx-runtime").JSX.Element;
30
+ export declare function KjunFormSkeleton({ fields, columns, multiline, size, loadingText, }: KjunFormSkeletonProps): import("react/jsx-runtime").JSX.Element;
22
31
  export interface KjunChartSkeletonProps {
23
32
  kind?: KjunChartSkeletonKind;
24
33
  height?: CSSProperties["height"];
@@ -27,7 +36,13 @@ export interface KjunChartSkeletonProps {
27
36
  loadingDelay?: number;
28
37
  rows?: number;
29
38
  columns?: number;
39
+ /** Frame: horizontal grid lines of the app's chart, top to baseline (default 5). */
40
+ gridLines?: number;
41
+ /** Frame: x-axis tick labels (default 6). */
42
+ xTicks?: number;
43
+ /** Frame: y-axis label width in px (default 40); label bars fill it, less the label gap. */
44
+ axisWidth?: number;
30
45
  }
31
- export declare function KjunChartSkeleton({ kind: requestedKind, height, loadingText, skeleton, loadingDelay, rows, columns, }: KjunChartSkeletonProps): import("react/jsx-runtime").JSX.Element;
46
+ export declare function KjunChartSkeleton({ kind: requestedKind, height, loadingText, skeleton, loadingDelay, rows, columns, gridLines, xTicks, axisWidth, }: KjunChartSkeletonProps): import("react/jsx-runtime").JSX.Element;
32
47
  export { KjunMarketTableSkeleton } from "./market-skeleton.js";
33
48
  export type { KjunMarketTableSkeletonProps } from "./market-skeleton.js";
@@ -1,9 +1,12 @@
1
- import type { KeyboardEvent } from "react";
2
- import type { TableCardsProps } from "../../../shared/package-runtime/table-presentation.cjs";
1
+ import type { KeyboardEvent, ReactNode } from "react";
2
+ import { type TableCardsProps } from "../../../shared/package-runtime/table-presentation.cjs";
3
+ import type { TableRowGroup } from "../../../shared/package-runtime/table-groups.cjs";
3
4
  interface Props<Row extends object> extends TableCardsProps<Row> {
4
5
  ariaLabel: string;
5
6
  customClass: (row: Row, index: number) => string;
6
7
  rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
8
  }
8
- export declare function TableCards<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, layout, ariaLabel, customClass, rowKeyDown }: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
+ /** Groups as labelled groups, each a header line over its own list; ungrouped rows stay one list. */
10
+ export declare function useTableGroups<Row extends object>({ groupLabel, groupTotals, state }: Pick<TableCardsProps<Row>, "groupLabel" | "groupTotals" | "state">, className: string, itemsClass: string | undefined, item: (row: Row, index: number) => ReactNode): (list: TableRowGroup<Row>[]) => import("react/jsx-runtime").JSX.Element[];
11
+ export declare function TableCards<Row extends object>(props: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
12
  export {};
@@ -1,9 +1,12 @@
1
- import type { KeyboardEvent } from "react";
2
- import type { TableCardsProps } from "../../../shared/package-runtime/table-presentation.js";
1
+ import type { KeyboardEvent, ReactNode } from "react";
2
+ import { type TableCardsProps } from "../../../shared/package-runtime/table-presentation.js";
3
+ import type { TableRowGroup } from "../../../shared/package-runtime/table-groups.js";
3
4
  interface Props<Row extends object> extends TableCardsProps<Row> {
4
5
  ariaLabel: string;
5
6
  customClass: (row: Row, index: number) => string;
6
7
  rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
8
  }
8
- export declare function TableCards<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, layout, ariaLabel, customClass, rowKeyDown }: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
+ /** Groups as labelled groups, each a header line over its own list; ungrouped rows stay one list. */
10
+ export declare function useTableGroups<Row extends object>({ groupLabel, groupTotals, state }: Pick<TableCardsProps<Row>, "groupLabel" | "groupTotals" | "state">, className: string, itemsClass: string | undefined, item: (row: Row, index: number) => ReactNode): (list: TableRowGroup<Row>[]) => import("react/jsx-runtime").JSX.Element[];
11
+ export declare function TableCards<Row extends object>(props: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
12
  export {};
@@ -5,5 +5,5 @@ interface Props<Row extends object> extends TableGridProps<Row, CSSProperties["m
5
5
  customClass: (row: Row, index: number) => string;
6
6
  rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
7
  }
8
- export declare function TableGrid<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, visible, maxHeight, stickyHeader, sortable, compact, striped, hoverable, ariaLabel, customClass, rowKeyDown }: Props<Row>): import("react/jsx-runtime").JSX.Element;
8
+ export declare function TableGrid<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, visible, maxHeight, stickyHeader, sortable, compact, striped, hoverable, ariaLabel, customClass, rowKeyDown, groups, collapsed, toggleGroup, groupLabel, summary, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
9
  export {};
@@ -5,5 +5,5 @@ interface Props<Row extends object> extends TableGridProps<Row, CSSProperties["m
5
5
  customClass: (row: Row, index: number) => string;
6
6
  rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
7
  }
8
- export declare function TableGrid<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, visible, maxHeight, stickyHeader, sortable, compact, striped, hoverable, ariaLabel, customClass, rowKeyDown }: Props<Row>): import("react/jsx-runtime").JSX.Element;
8
+ export declare function TableGrid<Row extends object>({ initialLoading, skeletonRows, skeletonHidden, state, onRowClick, selectable, checkbox, cell, expandable, expand, renderExpand, emptyContent, emptyText, visible, maxHeight, stickyHeader, sortable, compact, striped, hoverable, ariaLabel, customClass, rowKeyDown, groups, collapsed, toggleGroup, groupLabel, summary, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
9
9
  export {};
@@ -0,0 +1,10 @@
1
+ import type { KeyboardEvent } from "react";
2
+ import type { TableCardsProps } from "../../../shared/package-runtime/table-presentation.cjs";
3
+ interface Props<Row extends object> extends TableCardsProps<Row> {
4
+ ariaLabel: string;
5
+ customClass: (row: Row, index: number) => string;
6
+ rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
+ }
8
+ /** responsive="list": no header row; each row is a title over one meta line with its value and badges at the end. */
9
+ export declare function TableList<Row extends object>(props: Props<Row>): import("react/jsx-runtime").JSX.Element;
10
+ export {};
@@ -0,0 +1,10 @@
1
+ import type { KeyboardEvent } from "react";
2
+ import type { TableCardsProps } from "../../../shared/package-runtime/table-presentation.js";
3
+ interface Props<Row extends object> extends TableCardsProps<Row> {
4
+ ariaLabel: string;
5
+ customClass: (row: Row, index: number) => string;
6
+ rowKeyDown: (event: KeyboardEvent<HTMLElement>, row: Row, index: number) => void;
7
+ }
8
+ /** responsive="list": no header row; each row is a title over one meta line with its value and badges at the end. */
9
+ export declare function TableList<Row extends object>(props: Props<Row>): import("react/jsx-runtime").JSX.Element;
10
+ export {};
@@ -6,6 +6,7 @@ export interface KjunTableProps<Row extends object = Record<string, unknown>> ex
6
6
  }
7
7
  export declare function useTableModel<Row extends object>(props: KjunTableProps<Row>): {
8
8
  rows: Row[];
9
+ rowIndex: (row: Row) => number;
9
10
  key: (row: Row, index?: number) => string | number;
10
11
  sort: import("@kjun-ui/tokens").TableSort;
11
12
  search: string;
@@ -15,6 +16,7 @@ export declare function useTableModel<Row extends object>(props: KjunTableProps<
15
16
  expanded: (string | number)[];
16
17
  searchChange: (q: string) => void;
17
18
  sortColumn: (col: import("./table-model.cjs").TableColumn<Row>) => void;
19
+ sortTo: (next: import("@kjun-ui/tokens").TableSort) => void;
18
20
  toggleRow: (row: Row) => void | undefined;
19
21
  toggleAll: () => void | undefined;
20
22
  toggleExpand: (row: Row, index: number) => void;
@@ -6,6 +6,7 @@ export interface KjunTableProps<Row extends object = Record<string, unknown>> ex
6
6
  }
7
7
  export declare function useTableModel<Row extends object>(props: KjunTableProps<Row>): {
8
8
  rows: Row[];
9
+ rowIndex: (row: Row) => number;
9
10
  key: (row: Row, index?: number) => string | number;
10
11
  sort: import("@kjun-ui/tokens").TableSort;
11
12
  search: string;
@@ -15,6 +16,7 @@ export declare function useTableModel<Row extends object>(props: KjunTableProps<
15
16
  expanded: (string | number)[];
16
17
  searchChange: (q: string) => void;
17
18
  sortColumn: (col: import("./table-model.js").TableColumn<Row>) => void;
19
+ sortTo: (next: import("@kjun-ui/tokens").TableSort) => void;
18
20
  toggleRow: (row: Row) => void | undefined;
19
21
  toggleAll: () => void | undefined;
20
22
  toggleExpand: (row: Row, index: number) => void;
@@ -1,2 +1,2 @@
1
1
  import type { TableToolbarProps } from "../../../shared/package-runtime/table-presentation.cjs";
2
- export declare function TableToolbar<Row extends object>({ selectable, selected, toggleAll, clearSelection, renderSelectionToolbar, searchable, search, searchChange, searchPlaceholder, toolbar }: TableToolbarProps<Row>): import("react/jsx-runtime").JSX.Element;
2
+ export declare function TableToolbar<Row extends object>({ selectable, selected, allSelected, toggleAll, clearSelection, renderSelectionToolbar, searchable, search, searchChange, searchPlaceholder, toolbar, sortOptions, sortValue, sortChange }: TableToolbarProps<Row>): import("react/jsx-runtime").JSX.Element;
@@ -1,2 +1,2 @@
1
1
  import type { TableToolbarProps } from "../../../shared/package-runtime/table-presentation.js";
2
- export declare function TableToolbar<Row extends object>({ selectable, selected, toggleAll, clearSelection, renderSelectionToolbar, searchable, search, searchChange, searchPlaceholder, toolbar }: TableToolbarProps<Row>): import("react/jsx-runtime").JSX.Element;
2
+ export declare function TableToolbar<Row extends object>({ selectable, selected, allSelected, toggleAll, clearSelection, renderSelectionToolbar, searchable, search, searchChange, searchPlaceholder, toolbar, sortOptions, sortValue, sortChange }: TableToolbarProps<Row>): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,5 @@
1
+ import type { TableTotal } from "../../../shared/package-runtime/table-presentation.cjs";
2
+ /** The summary on narrow layouts: one closing block with each summarized column's total. */
3
+ export declare function TableTotals({ totals }: {
4
+ totals?: TableTotal[];
5
+ }): import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,5 @@
1
+ import type { TableTotal } from "../../../shared/package-runtime/table-presentation.js";
2
+ /** The summary on narrow layouts: one closing block with each summarized column's total. */
3
+ export declare function TableTotals({ totals }: {
4
+ totals?: TableTotal[];
5
+ }): import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,38 @@
1
+ import { type ReactNode } from "react";
2
+ export interface TabItem {
3
+ name: string;
4
+ label: string;
5
+ icon?: string;
6
+ /** A count or short text after the label; numbers over 99 show 99+, and 0 or "" draws nothing. */
7
+ badge?: string | number;
8
+ badgeVariant?: "default" | "secondary" | "primary" | "danger" | "success" | "warning" | "info";
9
+ disabled?: boolean;
10
+ }
11
+ export interface KjunTabsProps {
12
+ value: string;
13
+ items?: TabItem[];
14
+ density?: "comfortable" | "compact";
15
+ variant?: "underline" | "pills";
16
+ /** Tabs share the row equally; an underline then spans the whole tab. */
17
+ fullWidth?: boolean;
18
+ actions?: ReactNode;
19
+ children?: ReactNode;
20
+ /** Keep the header inside its scroll container while the tab panels scroll. */
21
+ stickyHeader?: boolean;
22
+ /** Top gap of the sticky header: a number in px or a CSS length. */
23
+ stickyOffset?: number | string;
24
+ ariaLabel?: string;
25
+ onValueChange?: (value: string) => void;
26
+ onChange?: (value: string) => void;
27
+ onTabMenu?: (event: {
28
+ name: string;
29
+ x: number;
30
+ y: number;
31
+ pointer: "mouse" | "touch";
32
+ }) => void;
33
+ }
34
+ export declare function KjunTabs({ value, items, density, variant, fullWidth, actions, children, stickyHeader, stickyOffset, ariaLabel, onValueChange, onChange, onTabMenu, }: KjunTabsProps): import("react/jsx-runtime").JSX.Element;
35
+ export interface KjunTabPaneProps extends TabItem {
36
+ children?: ReactNode;
37
+ }
38
+ export declare function KjunTabPane({ name, children }: KjunTabPaneProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,38 @@
1
+ import { type ReactNode } from "react";
2
+ export interface TabItem {
3
+ name: string;
4
+ label: string;
5
+ icon?: string;
6
+ /** A count or short text after the label; numbers over 99 show 99+, and 0 or "" draws nothing. */
7
+ badge?: string | number;
8
+ badgeVariant?: "default" | "secondary" | "primary" | "danger" | "success" | "warning" | "info";
9
+ disabled?: boolean;
10
+ }
11
+ export interface KjunTabsProps {
12
+ value: string;
13
+ items?: TabItem[];
14
+ density?: "comfortable" | "compact";
15
+ variant?: "underline" | "pills";
16
+ /** Tabs share the row equally; an underline then spans the whole tab. */
17
+ fullWidth?: boolean;
18
+ actions?: ReactNode;
19
+ children?: ReactNode;
20
+ /** Keep the header inside its scroll container while the tab panels scroll. */
21
+ stickyHeader?: boolean;
22
+ /** Top gap of the sticky header: a number in px or a CSS length. */
23
+ stickyOffset?: number | string;
24
+ ariaLabel?: string;
25
+ onValueChange?: (value: string) => void;
26
+ onChange?: (value: string) => void;
27
+ onTabMenu?: (event: {
28
+ name: string;
29
+ x: number;
30
+ y: number;
31
+ pointer: "mouse" | "touch";
32
+ }) => void;
33
+ }
34
+ export declare function KjunTabs({ value, items, density, variant, fullWidth, actions, children, stickyHeader, stickyOffset, ariaLabel, onValueChange, onChange, onTabMenu, }: KjunTabsProps): import("react/jsx-runtime").JSX.Element;
35
+ export interface KjunTabPaneProps extends TabItem {
36
+ children?: ReactNode;
37
+ }
38
+ export declare function KjunTabPane({ name, children }: KjunTabPaneProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,29 @@
1
+ import { type TextareaSubmitKey } from "../../../shared/package-runtime/textarea.cjs";
2
+ import { type InputSize } from "@kjun-ui/tokens";
3
+ import { type ReactNode, type TextareaHTMLAttributes } from "react";
4
+ export interface KjunTextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size" | "value" | "onSubmit"> {
5
+ value: string;
6
+ size?: InputSize;
7
+ error?: boolean;
8
+ /** Manual resizing (default "none"). A field the user can drag taller keeps that height instead of growing with its text. */
9
+ resize?: "none" | "vertical" | "horizontal" | "both";
10
+ ariaLabel?: string;
11
+ /** The field grows with its text from rows up to maxRows, then scrolls (default 6; rows keeps it fixed). */
12
+ maxRows?: number;
13
+ /** Character limit (UTF-16 units, like the attribute); the count shows "length/maxLength" and a longer value reads as an error. */
14
+ maxLength?: number;
15
+ /** Shows the character count inside the field, as "length/maxLength" when maxLength is set. */
16
+ showCount?: boolean;
17
+ /** Composer: controls at the start of the bar inside the field (attach, mention). */
18
+ actions?: ReactNode;
19
+ /** Composer: shows a submit button at the end of the bar, named by this label. */
20
+ submitLabel?: string;
21
+ /** Sends the text: the submit button or the submit key, while there is text within maxLength and nothing is sending. */
22
+ onSubmit?: (value: string) => void;
23
+ /** "mod-enter" (default) sends on Ctrl/⌘+Enter; "enter" sends on Enter, and Shift+Enter starts a new line. */
24
+ submitOn?: TextareaSubmitKey;
25
+ /** Sending: the submit button spins and the field ignores further sends until it ends. */
26
+ submitting?: boolean;
27
+ onValueChange?: (value: string) => void;
28
+ }
29
+ export declare const KjunTextarea: import("react").ForwardRefExoticComponent<KjunTextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
@@ -0,0 +1,29 @@
1
+ import { type TextareaSubmitKey } from "../../../shared/package-runtime/textarea.js";
2
+ import { type InputSize } from "@kjun-ui/tokens";
3
+ import { type ReactNode, type TextareaHTMLAttributes } from "react";
4
+ export interface KjunTextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size" | "value" | "onSubmit"> {
5
+ value: string;
6
+ size?: InputSize;
7
+ error?: boolean;
8
+ /** Manual resizing (default "none"). A field the user can drag taller keeps that height instead of growing with its text. */
9
+ resize?: "none" | "vertical" | "horizontal" | "both";
10
+ ariaLabel?: string;
11
+ /** The field grows with its text from rows up to maxRows, then scrolls (default 6; rows keeps it fixed). */
12
+ maxRows?: number;
13
+ /** Character limit (UTF-16 units, like the attribute); the count shows "length/maxLength" and a longer value reads as an error. */
14
+ maxLength?: number;
15
+ /** Shows the character count inside the field, as "length/maxLength" when maxLength is set. */
16
+ showCount?: boolean;
17
+ /** Composer: controls at the start of the bar inside the field (attach, mention). */
18
+ actions?: ReactNode;
19
+ /** Composer: shows a submit button at the end of the bar, named by this label. */
20
+ submitLabel?: string;
21
+ /** Sends the text: the submit button or the submit key, while there is text within maxLength and nothing is sending. */
22
+ onSubmit?: (value: string) => void;
23
+ /** "mod-enter" (default) sends on Ctrl/⌘+Enter; "enter" sends on Enter, and Shift+Enter starts a new line. */
24
+ submitOn?: TextareaSubmitKey;
25
+ /** Sending: the submit button spins and the field ignores further sends until it ends. */
26
+ submitting?: boolean;
27
+ onValueChange?: (value: string) => void;
28
+ }
29
+ export declare const KjunTextarea: import("react").ForwardRefExoticComponent<KjunTextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
@@ -1,3 +1,4 @@
1
+ import { type HourCycle } from "../../../shared/package-runtime/time-segments.cjs";
1
2
  import { type TimePrecision, type InputSize } from "@kjun-ui/tokens";
2
3
  export interface KjunTimePickerProps {
3
4
  value: string | null;
@@ -11,7 +12,15 @@ export interface KjunTimePickerProps {
11
12
  clearable?: boolean;
12
13
  size?: InputSize;
13
14
  ariaLabel?: string;
15
+ /** 24 (default) shows 00–23; 12 adds an AM/PM segment and shows 1–12. The value stays "HH:mm". */
16
+ hourCycle?: HourCycle;
17
+ /** Shows the time without changing it. */
18
+ readOnly?: boolean;
19
+ /** Submits the value with a form through a hidden input. */
20
+ name?: string;
21
+ /** Stretches the field to its container's width (default false: the field hugs the time). */
22
+ block?: boolean;
14
23
  onValueChange?: (value: string | null) => void;
15
24
  onChangeCommit?: (value: string | null) => void;
16
25
  }
17
- export declare function KjunTimePicker({ value, precision, min, max, minuteStep, secondStep, disabled, error, clearable, size, ariaLabel, onValueChange, onChangeCommit }: KjunTimePickerProps): import("react/jsx-runtime").JSX.Element;
26
+ export declare function KjunTimePicker({ value, precision, min, max, minuteStep, secondStep, disabled, error, clearable, size, ariaLabel, hourCycle, readOnly, name, block, onValueChange, onChangeCommit }: KjunTimePickerProps): import("react/jsx-runtime").JSX.Element;
@@ -1,3 +1,4 @@
1
+ import { type HourCycle } from "../../../shared/package-runtime/time-segments.js";
1
2
  import { type TimePrecision, type InputSize } from "@kjun-ui/tokens";
2
3
  export interface KjunTimePickerProps {
3
4
  value: string | null;
@@ -11,7 +12,15 @@ export interface KjunTimePickerProps {
11
12
  clearable?: boolean;
12
13
  size?: InputSize;
13
14
  ariaLabel?: string;
15
+ /** 24 (default) shows 00–23; 12 adds an AM/PM segment and shows 1–12. The value stays "HH:mm". */
16
+ hourCycle?: HourCycle;
17
+ /** Shows the time without changing it. */
18
+ readOnly?: boolean;
19
+ /** Submits the value with a form through a hidden input. */
20
+ name?: string;
21
+ /** Stretches the field to its container's width (default false: the field hugs the time). */
22
+ block?: boolean;
14
23
  onValueChange?: (value: string | null) => void;
15
24
  onChangeCommit?: (value: string | null) => void;
16
25
  }
17
- export declare function KjunTimePicker({ value, precision, min, max, minuteStep, secondStep, disabled, error, clearable, size, ariaLabel, onValueChange, onChangeCommit }: KjunTimePickerProps): import("react/jsx-runtime").JSX.Element;
26
+ export declare function KjunTimePicker({ value, precision, min, max, minuteStep, secondStep, disabled, error, clearable, size, ariaLabel, hourCycle, readOnly, name, block, onValueChange, onChangeCommit }: KjunTimePickerProps): import("react/jsx-runtime").JSX.Element;
@@ -1,6 +1,11 @@
1
1
  import type { createFeedbackController } from "@kjun-ui/tokens";
2
2
  import { type PresentedToast } from "../../../shared/package-runtime/feedback-motion.cjs";
3
- export declare function ToastStack({ items, controller }: {
3
+ import { type ToastPlacement } from "../../../shared/package-runtime/toast-placement.cjs";
4
+ type Controller = ReturnType<typeof createFeedbackController>;
5
+ export declare function ToastStack({ items, controller, placement, offset }: {
4
6
  items: PresentedToast[];
5
- controller: ReturnType<typeof createFeedbackController>;
7
+ controller: Controller;
8
+ placement?: ToastPlacement;
9
+ offset?: number;
6
10
  }): import("react/jsx-runtime").JSX.Element;
11
+ export {};