@kjun-ui/react 0.13.0 → 0.15.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 (40) hide show
  1. package/dist/index.cjs +613 -435
  2. package/dist/index.js +508 -329
  3. package/dist/styles.css +73 -1
  4. package/dist/types/packages/react/src/card.d.cts +8 -2
  5. package/dist/types/packages/react/src/card.d.ts +8 -2
  6. package/dist/types/packages/react/src/collapse.d.cts +3 -1
  7. package/dist/types/packages/react/src/collapse.d.ts +3 -1
  8. package/dist/types/packages/react/src/combobox.d.cts +6 -2
  9. package/dist/types/packages/react/src/combobox.d.ts +6 -2
  10. package/dist/types/packages/react/src/display.d.cts +2 -1
  11. package/dist/types/packages/react/src/display.d.ts +2 -1
  12. package/dist/types/packages/react/src/drawer.d.cts +3 -1
  13. package/dist/types/packages/react/src/drawer.d.ts +3 -1
  14. package/dist/types/packages/react/src/dropdown.d.cts +4 -2
  15. package/dist/types/packages/react/src/dropdown.d.ts +4 -2
  16. package/dist/types/packages/react/src/feedback.d.cts +5 -2
  17. package/dist/types/packages/react/src/feedback.d.ts +5 -2
  18. package/dist/types/packages/react/src/floating-panel.d.cts +3 -0
  19. package/dist/types/packages/react/src/floating-panel.d.ts +3 -0
  20. package/dist/types/packages/react/src/layout-primitives.d.cts +1 -1
  21. package/dist/types/packages/react/src/layout-primitives.d.ts +1 -1
  22. package/dist/types/packages/react/src/list.d.cts +17 -2
  23. package/dist/types/packages/react/src/list.d.ts +17 -2
  24. package/dist/types/packages/react/src/media.d.cts +4 -2
  25. package/dist/types/packages/react/src/media.d.ts +4 -2
  26. package/dist/types/packages/react/src/modal.d.cts +3 -1
  27. package/dist/types/packages/react/src/modal.d.ts +3 -1
  28. package/dist/types/packages/react/src/navigation.d.cts +7 -1
  29. package/dist/types/packages/react/src/navigation.d.ts +7 -1
  30. package/dist/types/packages/react/src/select-control.d.cts +4 -1
  31. package/dist/types/packages/react/src/select-control.d.ts +4 -1
  32. package/dist/types/shared/package-runtime/layout-primitives.d.cts +1 -1
  33. package/dist/types/shared/package-runtime/layout-primitives.d.ts +1 -1
  34. package/dist/types/shared/package-runtime/nested-controls.d.cts +2 -0
  35. package/dist/types/shared/package-runtime/nested-controls.d.ts +2 -0
  36. package/dist/types/shared/package-runtime/progress-circle.d.cts +11 -0
  37. package/dist/types/shared/package-runtime/progress-circle.d.ts +11 -0
  38. package/dist/types/shared/package-runtime/use-after-close.d.cts +6 -0
  39. package/dist/types/shared/package-runtime/use-after-close.d.ts +6 -0
  40. package/package.json +3 -3
@@ -1,5 +1,6 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
2
  import { type ReactNode } from "react";
3
+ import { type FocusReturn } from "./floating-panel.js";
3
4
  import { OptionValue, SelectOption } from "./select-options.js";
4
5
  export interface KjunSelectProps<T extends SelectOption = SelectOption> {
5
6
  value: OptionValue | OptionValue[] | null;
@@ -34,5 +35,7 @@ export interface KjunSelectProps<T extends SelectOption = SelectOption> {
34
35
  /** Extra option fields searched after the label. */
35
36
  searchKeys?: string[];
36
37
  onClear?: () => void;
38
+ /** Where focus goes when the menu closes by choosing or Escape, instead of the trigger (e.g. an edited cell). Web only. */
39
+ returnFocus?: FocusReturn;
37
40
  }
38
- 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, }: KjunSelectProps<T>): import("react/jsx-runtime").JSX.Element;
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;
@@ -1,5 +1,5 @@
1
1
  export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "body" | "label" | "meta" | "caption" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg";
2
- export type TextTone = "default" | "secondary" | "tertiary" | "disabled";
2
+ export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "inverse";
3
3
  export type TextAlign = "start" | "center" | "end";
4
4
  export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div";
5
5
  export type StackGap = "none" | "sm" | "md" | "lg" | "section-sm" | "section-md" | "section-lg";
@@ -1,5 +1,5 @@
1
1
  export type TextVariant = "pageTitle" | "sectionTitle" | "cardTitle" | "body" | "label" | "meta" | "caption" | "numberSm" | "numberMd" | "numberLg" | "displaySm" | "displayMd" | "displayLg";
2
- export type TextTone = "default" | "secondary" | "tertiary" | "disabled";
2
+ export type TextTone = "default" | "secondary" | "tertiary" | "disabled" | "brand" | "danger" | "success" | "warning" | "inverse";
3
3
  export type TextAlign = "start" | "center" | "end";
4
4
  export type TextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div";
5
5
  export type StackGap = "none" | "sm" | "md" | "lg" | "section-sm" | "section-md" | "section-lg";
@@ -0,0 +1,2 @@
1
+ /** Development only: warns once per call when `root` holds a control. */
2
+ export declare function warnNestedControls(root: Element | null | undefined, message: string): void;
@@ -0,0 +1,2 @@
1
+ /** Development only: warns once per call when `root` holds a control. */
2
+ export declare function warnNestedControls(root: Element | null | undefined, message: string): void;
@@ -0,0 +1,11 @@
1
+ export type ProgressCircleSize = "sm" | "md" | "lg";
2
+ /** Circle progress geometry: the arc is a dashed stroke whose visible length is the percentage of the circumference. */
3
+ export declare function progressCircle(size: ProgressCircleSize, percentage: number): {
4
+ diameter: 24 | 48 | 64;
5
+ stroke: 4 | 6;
6
+ radius: number;
7
+ centre: number;
8
+ circumference: number;
9
+ offset: number;
10
+ showsPercentage: boolean;
11
+ };
@@ -0,0 +1,11 @@
1
+ export type ProgressCircleSize = "sm" | "md" | "lg";
2
+ /** Circle progress geometry: the arc is a dashed stroke whose visible length is the percentage of the circumference. */
3
+ export declare function progressCircle(size: ProgressCircleSize, percentage: number): {
4
+ diameter: 24 | 48 | 64;
5
+ stroke: 4 | 6;
6
+ radius: number;
7
+ centre: number;
8
+ circumference: number;
9
+ offset: number;
10
+ showsPercentage: boolean;
11
+ };
@@ -0,0 +1,6 @@
1
+ /** Calls onAfterClose once when a layer leaves the screen (present true → false). A reopen during the exit keeps
2
+ * present true, so it reports nothing; a layer mounted closed reports nothing either. */
3
+ export declare function useAfterClose(present: boolean, onAfterClose?: () => void, enabled?: boolean): void;
4
+ /** Web overlays can outlive present by a render (react-aria finishes its exit first), so this reports when the
5
+ * overlay element itself leaves the DOM while closed. Attach the returned ref to the overlay. */
6
+ export declare function useAfterCloseRef(open: boolean, onAfterClose?: () => void): (node: Element | null) => void;
@@ -0,0 +1,6 @@
1
+ /** Calls onAfterClose once when a layer leaves the screen (present true → false). A reopen during the exit keeps
2
+ * present true, so it reports nothing; a layer mounted closed reports nothing either. */
3
+ export declare function useAfterClose(present: boolean, onAfterClose?: () => void, enabled?: boolean): void;
4
+ /** Web overlays can outlive present by a render (react-aria finishes its exit first), so this reports when the
5
+ * overlay element itself leaves the DOM while closed. Attach the returned ref to the overlay. */
6
+ export declare function useAfterCloseRef(open: boolean, onAfterClose?: () => void): (node: Element | null) => void;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kjun-ui/react",
3
- "version": "0.13.0",
3
+ "version": "0.15.0",
4
4
  "license": "MIT",
5
5
  "homepage": "https://ui.kjun.dev",
6
6
  "repository": {
@@ -41,9 +41,9 @@
41
41
  "./package.json": "./package.json"
42
42
  },
43
43
  "dependencies": {
44
- "@kjun-ui/tokens": "0.13.0",
44
+ "@kjun-ui/tokens": "0.15.0",
45
45
  "react-aria-components": "1.21.1",
46
- "@kjun-ui/icons": "0.13.0"
46
+ "@kjun-ui/icons": "0.15.0"
47
47
  },
48
48
  "peerDependencies": {
49
49
  "react": "^19.2.3",