@kjun-ui/react 0.22.0 → 0.23.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 (56) hide show
  1. package/dist/index.cjs +633 -256
  2. package/dist/index.js +741 -363
  3. package/dist/styles.css +140 -40
  4. package/dist/types/packages/react/src/app-navigation.d.cts +9 -3
  5. package/dist/types/packages/react/src/app-navigation.d.ts +9 -3
  6. package/dist/types/packages/react/src/button.d.cts +2 -1
  7. package/dist/types/packages/react/src/button.d.ts +2 -1
  8. package/dist/types/packages/react/src/display.d.cts +9 -4
  9. package/dist/types/packages/react/src/display.d.ts +9 -4
  10. package/dist/types/packages/react/src/dropdown.d.cts +2 -1
  11. package/dist/types/packages/react/src/dropdown.d.ts +2 -1
  12. package/dist/types/packages/react/src/input.d.cts +14 -1
  13. package/dist/types/packages/react/src/input.d.ts +14 -1
  14. package/dist/types/packages/react/src/list.d.cts +12 -6
  15. package/dist/types/packages/react/src/list.d.ts +12 -6
  16. package/dist/types/packages/react/src/market-model.d.cts +2 -0
  17. package/dist/types/packages/react/src/market-model.d.ts +2 -0
  18. package/dist/types/packages/react/src/number-input.d.cts +1 -1
  19. package/dist/types/packages/react/src/number-input.d.ts +1 -1
  20. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.cts +31 -0
  21. package/dist/types/packages/react/src/side-navigation-layout-spaces.d.ts +31 -0
  22. package/dist/types/packages/react/src/side-navigation-layout.d.cts +17 -1
  23. package/dist/types/packages/react/src/side-navigation-layout.d.ts +17 -1
  24. package/dist/types/packages/react/src/split-pane.d.cts +3 -1
  25. package/dist/types/packages/react/src/split-pane.d.ts +3 -1
  26. package/dist/types/packages/react/src/steps.d.cts +3 -2
  27. package/dist/types/packages/react/src/steps.d.ts +3 -2
  28. package/dist/types/packages/react/src/table-grid.d.cts +1 -1
  29. package/dist/types/packages/react/src/table-grid.d.ts +1 -1
  30. package/dist/types/shared/package-runtime/bottom-navigation.d.cts +5 -0
  31. package/dist/types/shared/package-runtime/bottom-navigation.d.ts +5 -0
  32. package/dist/types/shared/package-runtime/field-group.d.cts +17 -0
  33. package/dist/types/shared/package-runtime/field-group.d.ts +17 -0
  34. package/dist/types/shared/package-runtime/list-row.d.cts +28 -2
  35. package/dist/types/shared/package-runtime/list-row.d.ts +28 -2
  36. package/dist/types/shared/package-runtime/menu-button.d.cts +2 -2
  37. package/dist/types/shared/package-runtime/menu-button.d.ts +2 -2
  38. package/dist/types/shared/package-runtime/messages/ko.d.cts +3 -0
  39. package/dist/types/shared/package-runtime/messages/ko.d.ts +3 -0
  40. package/dist/types/shared/package-runtime/messages-context.d.cts +3 -0
  41. package/dist/types/shared/package-runtime/messages-context.d.ts +3 -0
  42. package/dist/types/shared/package-runtime/node-text.d.cts +1 -0
  43. package/dist/types/shared/package-runtime/node-text.d.ts +1 -0
  44. package/dist/types/shared/package-runtime/number-input.d.cts +10 -0
  45. package/dist/types/shared/package-runtime/number-input.d.ts +10 -0
  46. package/dist/types/shared/package-runtime/progress-tone.d.cts +6 -0
  47. package/dist/types/shared/package-runtime/progress-tone.d.ts +6 -0
  48. package/dist/types/shared/package-runtime/side-navigation-layout.d.cts +24 -0
  49. package/dist/types/shared/package-runtime/side-navigation-layout.d.ts +24 -0
  50. package/dist/types/shared/package-runtime/steps.d.cts +18 -4
  51. package/dist/types/shared/package-runtime/steps.d.ts +18 -4
  52. package/dist/types/shared/package-runtime/table-presentation.d.cts +1 -0
  53. package/dist/types/shared/package-runtime/table-presentation.d.ts +1 -0
  54. package/dist/types/shared/package-runtime/table.d.cts +2 -0
  55. package/dist/types/shared/package-runtime/table.d.ts +2 -0
  56. package/package.json +3 -3
@@ -39,7 +39,7 @@ export interface KjunSpinnerProps {
39
39
  text?: string;
40
40
  }
41
41
  export declare function KjunSpinner({ size, text }: KjunSpinnerProps): import("react/jsx-runtime").JSX.Element;
42
- export interface KjunAlertProps {
42
+ export interface KjunAlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "children" | "role"> {
43
43
  type?: "info" | "success" | "warning" | "danger" | "error";
44
44
  variant?: SemanticTone;
45
45
  size?: "sm" | "md" | "lg";
@@ -56,7 +56,9 @@ export interface KjunAlertProps {
56
56
  className?: string;
57
57
  onClose?: () => void;
58
58
  }
59
- export declare function KjunAlert({ type, variant, size, title, icon, closable, live, children, actions, className, onClose, }: KjunAlertProps): import("react/jsx-runtime").JSX.Element | null;
59
+ /** Other HTML attributes (id, style, tabIndex, aria-*, data-*) and the ref go to the root, so a page can point at the alert or move focus to it. */
60
+ export declare const KjunAlert: import("react").ForwardRefExoticComponent<KjunAlertProps & import("react").RefAttributes<HTMLDivElement>>;
61
+ export type KjunProgressVariant = SemanticTone | "neutral";
60
62
  export interface KjunProgressProps {
61
63
  /** null is missing data; omission keeps the zero default. */
62
64
  value?: number | null;
@@ -64,7 +66,8 @@ export interface KjunProgressProps {
64
66
  indeterminate?: boolean;
65
67
  max?: number;
66
68
  size?: "sm" | "md" | "lg";
67
- variant?: SemanticTone;
69
+ /** neutral draws the fill in the tertiary text colour, for a stale or reference reading that should not call for attention. */
70
+ variant?: KjunProgressVariant;
68
71
  showLabel?: boolean;
69
72
  /** Shown and read in place of the rounded percent while the value is known, e.g. "37.4%" or "3.2 / 8 GB". */
70
73
  valueText?: string;
@@ -73,10 +76,12 @@ export interface KjunProgressProps {
73
76
  /** Read by screen readers as the bar's description, e.g. "오늘 기준 53%". Put visible wording in subLabel. */
74
77
  markerLabel?: string;
75
78
  label?: ReactNode;
79
+ /** Names the bar for screen readers without showing text, e.g. "업로드 진행률"; takes the place of a label's name. */
80
+ ariaLabel?: string;
76
81
  subLabel?: ReactNode;
77
82
  shape?: "bar" | "circle";
78
83
  }
79
- export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, valueText, marker, markerLabel, label, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
84
+ export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, valueText, marker, markerLabel, label, ariaLabel, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;
80
85
  export interface KjunSkeletonProps {
81
86
  /** "line" is one line of text: a bar in the line box of `role`, or of the surrounding text when no role is given. */
82
87
  type?: "text" | "line" | "avatar" | "card" | "table" | "stat" | "block";
@@ -71,7 +71,8 @@ export interface KjunDropdownSubmenuProps {
71
71
  export declare function KjunDropdownSubmenu({ id, label, icon, disabled, children }: KjunDropdownSubmenuProps): import("react/jsx-runtime").JSX.Element;
72
72
  export declare function KjunDropdownDivider(): import("react/jsx-runtime").JSX.Element | null;
73
73
  export interface KjunMenuButtonProps extends Omit<KjunDropdownProps, "trigger"> {
74
- label?: string;
74
+ /** The visible label; a node can carry an icon or a colour swatch. Without readable text in it, give ariaLabel. */
75
+ label?: ReactNode;
75
76
  size?: KjunButtonProps["size"];
76
77
  variant?: KjunButtonProps["variant"];
77
78
  /** Show a square dots-vertical button; label remains its accessible name. */
@@ -71,7 +71,8 @@ export interface KjunDropdownSubmenuProps {
71
71
  export declare function KjunDropdownSubmenu({ id, label, icon, disabled, children }: KjunDropdownSubmenuProps): import("react/jsx-runtime").JSX.Element;
72
72
  export declare function KjunDropdownDivider(): import("react/jsx-runtime").JSX.Element | null;
73
73
  export interface KjunMenuButtonProps extends Omit<KjunDropdownProps, "trigger"> {
74
- label?: string;
74
+ /** The visible label; a node can carry an icon or a colour swatch. Without readable text in it, give ariaLabel. */
75
+ label?: ReactNode;
75
76
  size?: KjunButtonProps["size"];
76
77
  variant?: KjunButtonProps["variant"];
77
78
  /** Show a square dots-vertical button; label remains its accessible name. */
@@ -1,5 +1,6 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
2
  import { type InputVariant } from "../../../shared/package-runtime/input-variant.cjs";
3
+ import { type FormGroupElement } from "../../../shared/package-runtime/field-group.cjs";
3
4
  import { type InputHTMLAttributes, type ReactNode } from "react";
4
5
  interface FieldContextValue {
5
6
  id: string;
@@ -11,9 +12,18 @@ interface FieldContextValue {
11
12
  setControlId?: (id: string | undefined) => void;
12
13
  /** A control's own message (NumberInput's range) shown in the group's error slot; "" clears it. The group's error wins. */
13
14
  reportError?: (owner: string, message: string) => void;
15
+ /** Set by a fieldset FormGroup: the choice controls inside claim the group's id, and the owner wears it. */
16
+ group?: {
17
+ owner?: string;
18
+ claim: (key: string, disabled: boolean) => void;
19
+ release: (key: string) => void;
20
+ };
14
21
  }
15
22
  export declare const FieldContext: import("react").Context<FieldContextValue | null>;
16
23
  export declare const useKjunField: () => FieldContextValue | null;
24
+ /** In a fieldset FormGroup, the group's id for the first enabled choice control (field-group.ts), so app code can focus the
25
+ * group by that id; elsewhere, or when the control has its own id, the control's own id. */
26
+ export declare function useGroupFieldId(disabled: boolean, own?: string): string | undefined;
17
27
  export interface KjunFormGroupProps {
18
28
  label?: string;
19
29
  id?: string;
@@ -28,9 +38,12 @@ export interface KjunFormGroupProps {
28
38
  labelEnd?: ReactNode;
29
39
  /** Extra class on the group root, for placement in the page layout. */
30
40
  className?: string;
41
+ /** "fieldset" groups several choices (checkboxes, radios, FilterGroup, ButtonGroup) under one name: the root is a fieldset
42
+ * whose legend is the label and which the hint or error describes, and the id goes to the first enabled choice. */
43
+ as?: FormGroupElement;
31
44
  children: ReactNode;
32
45
  }
33
- export declare function KjunFormGroup({ label, id, required, optional, error, hint, labelHidden, labelEnd, className, children, }: KjunFormGroupProps): import("react/jsx-runtime").JSX.Element;
46
+ export declare function KjunFormGroup({ label, id, required, optional, error, hint, labelHidden, labelEnd, className, as, children, }: KjunFormGroupProps): import("react/jsx-runtime").JSX.Element;
34
47
  export interface KjunInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "value" | "defaultValue"> {
35
48
  size?: InputSize;
36
49
  /** "plain" drops the surface, side border and side inset for text edited in place, such as a document title. */
@@ -1,5 +1,6 @@
1
1
  import { type InputSize } from "@kjun-ui/tokens";
2
2
  import { type InputVariant } from "../../../shared/package-runtime/input-variant.js";
3
+ import { type FormGroupElement } from "../../../shared/package-runtime/field-group.js";
3
4
  import { type InputHTMLAttributes, type ReactNode } from "react";
4
5
  interface FieldContextValue {
5
6
  id: string;
@@ -11,9 +12,18 @@ interface FieldContextValue {
11
12
  setControlId?: (id: string | undefined) => void;
12
13
  /** A control's own message (NumberInput's range) shown in the group's error slot; "" clears it. The group's error wins. */
13
14
  reportError?: (owner: string, message: string) => void;
15
+ /** Set by a fieldset FormGroup: the choice controls inside claim the group's id, and the owner wears it. */
16
+ group?: {
17
+ owner?: string;
18
+ claim: (key: string, disabled: boolean) => void;
19
+ release: (key: string) => void;
20
+ };
14
21
  }
15
22
  export declare const FieldContext: import("react").Context<FieldContextValue | null>;
16
23
  export declare const useKjunField: () => FieldContextValue | null;
24
+ /** In a fieldset FormGroup, the group's id for the first enabled choice control (field-group.ts), so app code can focus the
25
+ * group by that id; elsewhere, or when the control has its own id, the control's own id. */
26
+ export declare function useGroupFieldId(disabled: boolean, own?: string): string | undefined;
17
27
  export interface KjunFormGroupProps {
18
28
  label?: string;
19
29
  id?: string;
@@ -28,9 +38,12 @@ export interface KjunFormGroupProps {
28
38
  labelEnd?: ReactNode;
29
39
  /** Extra class on the group root, for placement in the page layout. */
30
40
  className?: string;
41
+ /** "fieldset" groups several choices (checkboxes, radios, FilterGroup, ButtonGroup) under one name: the root is a fieldset
42
+ * whose legend is the label and which the hint or error describes, and the id goes to the first enabled choice. */
43
+ as?: FormGroupElement;
31
44
  children: ReactNode;
32
45
  }
33
- export declare function KjunFormGroup({ label, id, required, optional, error, hint, labelHidden, labelEnd, className, children, }: KjunFormGroupProps): import("react/jsx-runtime").JSX.Element;
46
+ export declare function KjunFormGroup({ label, id, required, optional, error, hint, labelHidden, labelEnd, className, as, children, }: KjunFormGroupProps): import("react/jsx-runtime").JSX.Element;
34
47
  export interface KjunInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix" | "value" | "defaultValue"> {
35
48
  size?: InputSize;
36
49
  /** "plain" drops the surface, side border and side inset for text edited in place, such as a document title. */
@@ -1,13 +1,14 @@
1
1
  import { type CardRadius } from "@kjun-ui/tokens";
2
2
  import { type CSSProperties, type MouseEvent, type ReactNode } from "react";
3
- import { type ListChoiceValue, type ListGroupVariant, type ListSectionVariant, type ListSelectionMode } from "../../../shared/package-runtime/list-row.cjs";
3
+ import { type ListChoiceValue, type ListGroupVariant, type ListSectionSurface, type ListSectionVariant, type ListSelectionMode } from "../../../shared/package-runtime/list-row.cjs";
4
4
  import { type KjunListReorderControls, type KjunListReorderMove } from "./reorder-controls.cjs";
5
5
  import { type ListLeadingSize } from "../../../shared/package-runtime/list-leading.cjs";
6
- export type { ListChoiceValue, ListGroupVariant, ListSectionVariant, ListTrailingPosition } from "../../../shared/package-runtime/list-row.cjs";
6
+ export type { ListChoiceValue, ListGroupVariant, ListSectionSurface, ListSectionVariant, ListTrailingPosition } from "../../../shared/package-runtime/list-row.cjs";
7
7
  export type { ListLeadingSize } from "../../../shared/package-runtime/list-leading.cjs";
8
8
  export type { KjunListReorderControls, KjunListReorderMove } from "./reorder-controls.cjs";
9
9
  export interface KjunListRowProps {
10
- title: string;
10
+ /** The row's title. A node can add a short mark in the title's own place and type, such as a ticker in the tertiary text colour; a screen reader hears its text, and without text give ariaLabel. */
11
+ title: ReactNode;
11
12
  description?: string;
12
13
  /** Content after the title, centered on its first line, such as a KjunBadge ("New", a count); a screen reader hears it with the title. */
13
14
  badge?: ReactNode;
@@ -79,8 +80,13 @@ export interface KjunListSectionProps {
79
80
  id?: string;
80
81
  className?: string;
81
82
  style?: CSSProperties;
82
- /** Paints the surface background (default true); false lets the page background show through. */
83
- surface?: boolean;
83
+ /** Paints the surface background (default true); false lets the page background show through; "muted" paints the muted fill, which sets rows apart inside a white card or modal. */
84
+ surface?: ListSectionSurface;
85
+ /** Runs the section past its container's content edge to the container's edge: inside a KjunCard body by the card's
86
+ * padding, elsewhere by the rows' 16px. Rows, heading and footer take that inset, so their text stays on the content line
87
+ * around the section while row fills and dividers reach the edge. The section is flat (radius does not apply); an open
88
+ * section keeps its own inset. Leave room for the overhang: a parent that clips its overflow cuts it off. */
89
+ bleed?: boolean;
84
90
  /** Draws dividers between rows (default true; false in a details section). An open section draws none; giving it true warns in development. */
85
91
  divider?: boolean;
86
92
  /** "compact" rows keep the 16px inset but are 44 tall (the touch minimum) instead of 56. A details section keeps its own 32px rows. */
@@ -121,7 +127,7 @@ export interface KjunListSectionProps {
121
127
  /** Why moving is off, shown under the rows and read with the buttons. */
122
128
  reorderDisabledText?: string;
123
129
  }
124
- export declare function KjunListSection({ title, description, badge, id: rootId, className, style, actions, children, ariaLabel, surface, divider: dividerProp, density, radius, titleVariant, headingLevel, empty, footer, loading, selectionMode, value, onValueChange, variant, reorderable, order, onOrderChange, onReorder, reorderControls, reorderDisabled, reorderDisabledText }: KjunListSectionProps): import("react/jsx-runtime").JSX.Element;
130
+ export declare function KjunListSection({ title, description, badge, id: rootId, className, style, actions, children, ariaLabel, surface, bleed: bleedProp, divider: dividerProp, density, radius, titleVariant, headingLevel, empty, footer, loading, selectionMode, value, onValueChange, variant, reorderable, order, onOrderChange, onReorder, reorderControls, reorderDisabled, reorderDisabledText }: KjunListSectionProps): import("react/jsx-runtime").JSX.Element;
125
131
  export interface KjunListGroupProps {
126
132
  /** id, class and style of the root. */
127
133
  id?: string;
@@ -1,13 +1,14 @@
1
1
  import { type CardRadius } from "@kjun-ui/tokens";
2
2
  import { type CSSProperties, type MouseEvent, type ReactNode } from "react";
3
- import { type ListChoiceValue, type ListGroupVariant, type ListSectionVariant, type ListSelectionMode } from "../../../shared/package-runtime/list-row.js";
3
+ import { type ListChoiceValue, type ListGroupVariant, type ListSectionSurface, type ListSectionVariant, type ListSelectionMode } from "../../../shared/package-runtime/list-row.js";
4
4
  import { type KjunListReorderControls, type KjunListReorderMove } from "./reorder-controls.js";
5
5
  import { type ListLeadingSize } from "../../../shared/package-runtime/list-leading.js";
6
- export type { ListChoiceValue, ListGroupVariant, ListSectionVariant, ListTrailingPosition } from "../../../shared/package-runtime/list-row.js";
6
+ export type { ListChoiceValue, ListGroupVariant, ListSectionSurface, ListSectionVariant, ListTrailingPosition } from "../../../shared/package-runtime/list-row.js";
7
7
  export type { ListLeadingSize } from "../../../shared/package-runtime/list-leading.js";
8
8
  export type { KjunListReorderControls, KjunListReorderMove } from "./reorder-controls.js";
9
9
  export interface KjunListRowProps {
10
- title: string;
10
+ /** The row's title. A node can add a short mark in the title's own place and type, such as a ticker in the tertiary text colour; a screen reader hears its text, and without text give ariaLabel. */
11
+ title: ReactNode;
11
12
  description?: string;
12
13
  /** Content after the title, centered on its first line, such as a KjunBadge ("New", a count); a screen reader hears it with the title. */
13
14
  badge?: ReactNode;
@@ -79,8 +80,13 @@ export interface KjunListSectionProps {
79
80
  id?: string;
80
81
  className?: string;
81
82
  style?: CSSProperties;
82
- /** Paints the surface background (default true); false lets the page background show through. */
83
- surface?: boolean;
83
+ /** Paints the surface background (default true); false lets the page background show through; "muted" paints the muted fill, which sets rows apart inside a white card or modal. */
84
+ surface?: ListSectionSurface;
85
+ /** Runs the section past its container's content edge to the container's edge: inside a KjunCard body by the card's
86
+ * padding, elsewhere by the rows' 16px. Rows, heading and footer take that inset, so their text stays on the content line
87
+ * around the section while row fills and dividers reach the edge. The section is flat (radius does not apply); an open
88
+ * section keeps its own inset. Leave room for the overhang: a parent that clips its overflow cuts it off. */
89
+ bleed?: boolean;
84
90
  /** Draws dividers between rows (default true; false in a details section). An open section draws none; giving it true warns in development. */
85
91
  divider?: boolean;
86
92
  /** "compact" rows keep the 16px inset but are 44 tall (the touch minimum) instead of 56. A details section keeps its own 32px rows. */
@@ -121,7 +127,7 @@ export interface KjunListSectionProps {
121
127
  /** Why moving is off, shown under the rows and read with the buttons. */
122
128
  reorderDisabledText?: string;
123
129
  }
124
- export declare function KjunListSection({ title, description, badge, id: rootId, className, style, actions, children, ariaLabel, surface, divider: dividerProp, density, radius, titleVariant, headingLevel, empty, footer, loading, selectionMode, value, onValueChange, variant, reorderable, order, onOrderChange, onReorder, reorderControls, reorderDisabled, reorderDisabledText }: KjunListSectionProps): import("react/jsx-runtime").JSX.Element;
130
+ export declare function KjunListSection({ title, description, badge, id: rootId, className, style, actions, children, ariaLabel, surface, bleed: bleedProp, divider: dividerProp, density, radius, titleVariant, headingLevel, empty, footer, loading, selectionMode, value, onValueChange, variant, reorderable, order, onOrderChange, onReorder, reorderControls, reorderDisabled, reorderDisabledText }: KjunListSectionProps): import("react/jsx-runtime").JSX.Element;
125
131
  export interface KjunListGroupProps {
126
132
  /** id, class and style of the root. */
127
133
  id?: string;
@@ -52,6 +52,8 @@ export interface MarketColumn {
52
52
  baselineKey?: string;
53
53
  /** Sparkline columns: every row shares one vertical range, for series on a common scale (such as percent changes). */
54
54
  sharedRange?: boolean;
55
+ /** MarketTable: draws this column's cells, while the other columns keep the built-in ones. renderCell wins over it. */
56
+ render?: (row: any, column: MarketColumn) => ReactNode;
55
57
  }
56
58
  export type MarketFormatter<Row extends object> = (value: unknown, format: string, context: {
57
59
  currency: string;
@@ -52,6 +52,8 @@ export interface MarketColumn {
52
52
  baselineKey?: string;
53
53
  /** Sparkline columns: every row shares one vertical range, for series on a common scale (such as percent changes). */
54
54
  sharedRange?: boolean;
55
+ /** MarketTable: draws this column's cells, while the other columns keep the built-in ones. renderCell wins over it. */
56
+ render?: (row: any, column: MarketColumn) => ReactNode;
55
57
  }
56
58
  export type MarketFormatter<Row extends object> = (value: unknown, format: string, context: {
57
59
  currency: string;
@@ -25,4 +25,4 @@ export interface KjunNumberInputProps extends NumberInputOptions {
25
25
  className?: string;
26
26
  style?: CSSProperties;
27
27
  }
28
- export declare function KjunNumberInput({ value, format, decimals, grouping, allowNegative, min, max, prefix, suffix, readingAid, align, size, disabled, readOnly, error, id, ariaLabel, placeholder, name, onValueChange, onChangeCommit, className, style, }: KjunNumberInputProps): import("react/jsx-runtime").JSX.Element;
28
+ export declare function KjunNumberInput({ value, format, decimals, grouping, allowNegative, min, max, step, prefix, suffix, readingAid, align, size, disabled, readOnly, error, id, ariaLabel, placeholder, name, onValueChange, onChangeCommit, className, style, }: KjunNumberInputProps): import("react/jsx-runtime").JSX.Element;
@@ -25,4 +25,4 @@ export interface KjunNumberInputProps extends NumberInputOptions {
25
25
  className?: string;
26
26
  style?: CSSProperties;
27
27
  }
28
- export declare function KjunNumberInput({ value, format, decimals, grouping, allowNegative, min, max, prefix, suffix, readingAid, align, size, disabled, readOnly, error, id, ariaLabel, placeholder, name, onValueChange, onChangeCommit, className, style, }: KjunNumberInputProps): import("react/jsx-runtime").JSX.Element;
28
+ export declare function KjunNumberInput({ value, format, decimals, grouping, allowNegative, min, max, step, prefix, suffix, readingAid, align, size, disabled, readOnly, error, id, ariaLabel, placeholder, name, onValueChange, onChangeCommit, className, style, }: KjunNumberInputProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,31 @@
1
+ import { type SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.cjs";
2
+ import { type CSSProperties, type ReactNode } from "react";
3
+ type Slot<S> = ReactNode | ((state: S) => ReactNode);
4
+ type State = {
5
+ collapsed: boolean;
6
+ drawer: boolean;
7
+ closeDrawer: () => void;
8
+ };
9
+ export interface SpacesLayoutProps {
10
+ spaces: Slot<State>;
11
+ nav: Slot<State>;
12
+ children?: ReactNode;
13
+ spacesTitle?: ReactNode;
14
+ panelSurface: SideNavigationPanelSurface;
15
+ panelCollapsed: boolean;
16
+ onPanelCollapsedChange?: (collapsed: boolean) => void;
17
+ panelLabel?: string;
18
+ narrow: boolean;
19
+ navOpen: boolean;
20
+ onNavOpenChange?: (open: boolean) => void;
21
+ closeDrawer: () => void;
22
+ drawerLabel?: string;
23
+ sticky: boolean;
24
+ offset?: CSSProperties;
25
+ classes: string;
26
+ }
27
+ /** KjunSideNavigationLayout with a spaces rail: a band in the rail colour holds the rail and the menu panel, whose head
28
+ * carries the space's name and the collapse button; the rail's top cell holds the expand button while the panel is
29
+ * collapsed. Below the breakpoint the whole band opens in the drawer, the panel always open there. */
30
+ export declare function SpacesLayout(p: SpacesLayoutProps): import("react/jsx-runtime").JSX.Element;
31
+ export {};
@@ -0,0 +1,31 @@
1
+ import { type SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.js";
2
+ import { type CSSProperties, type ReactNode } from "react";
3
+ type Slot<S> = ReactNode | ((state: S) => ReactNode);
4
+ type State = {
5
+ collapsed: boolean;
6
+ drawer: boolean;
7
+ closeDrawer: () => void;
8
+ };
9
+ export interface SpacesLayoutProps {
10
+ spaces: Slot<State>;
11
+ nav: Slot<State>;
12
+ children?: ReactNode;
13
+ spacesTitle?: ReactNode;
14
+ panelSurface: SideNavigationPanelSurface;
15
+ panelCollapsed: boolean;
16
+ onPanelCollapsedChange?: (collapsed: boolean) => void;
17
+ panelLabel?: string;
18
+ narrow: boolean;
19
+ navOpen: boolean;
20
+ onNavOpenChange?: (open: boolean) => void;
21
+ closeDrawer: () => void;
22
+ drawerLabel?: string;
23
+ sticky: boolean;
24
+ offset?: CSSProperties;
25
+ classes: string;
26
+ }
27
+ /** KjunSideNavigationLayout with a spaces rail: a band in the rail colour holds the rail and the menu panel, whose head
28
+ * carries the space's name and the collapse button; the rail's top cell holds the expand button while the panel is
29
+ * collapsed. Below the breakpoint the whole band opens in the drawer, the panel always open there. */
30
+ export declare function SpacesLayout(p: SpacesLayoutProps): import("react/jsx-runtime").JSX.Element;
31
+ export {};
@@ -1,6 +1,8 @@
1
1
  import { type SideNavigationWidth } from "../../../shared/package-runtime/side-navigation.cjs";
2
2
  import { type ReactNode } from "react";
3
+ import { type SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.cjs";
3
4
  export type { SideNavigationWidth } from "../../../shared/package-runtime/side-navigation.cjs";
5
+ export type { SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.cjs";
4
6
  /** Where the menu is drawn: in the column (collapsed or open) or in the drawer of a narrow screen, which is always open.
5
7
  * closeDrawer closes that drawer, e.g. in the menu's onNavigate; in the column it does nothing. */
6
8
  export type SideNavigationLayoutState = {
@@ -40,8 +42,22 @@ export interface KjunSideNavigationLayoutProps {
40
42
  onNavOpenChange?: (open: boolean) => void;
41
43
  /** The drawer's name for assistive technology; the menu's name by default. */
42
44
  drawerLabel?: string;
45
+ /** A rail of spaces, usually a collapsed KjunSideNavigation, before a menu panel that holds nav. The rail and the panel sit
46
+ * in a band in the navigation-rail-bg colour; the panel's head shows spacesTitle and a collapse button, and below the
47
+ * breakpoint the drawer holds both. With spaces, collapsed, railLabels and width do not apply, and railBreakpoint asks
48
+ * onPanelCollapsedChange instead. A function receives where it is drawn (collapsed is true: the rail is a collapsed menu). */
49
+ spaces?: ReactNode | ((state: SideNavigationLayoutState) => ReactNode);
50
+ /** The chosen space's name at the top of the panel, on one line. */
51
+ spacesTitle?: ReactNode;
52
+ /** The panel: a card set into the band ("card", default) or flat against it with a line before the page ("flat"). */
53
+ panelSurface?: SideNavigationPanelSurface;
54
+ /** The panel is collapsed and only the rail stays; the rail's top cell then holds the expand button. Default false. */
55
+ panelCollapsed?: boolean;
56
+ onPanelCollapsedChange?: (collapsed: boolean) => void;
57
+ /** The panel's name for assistive technology; "메뉴 패널" by default. */
58
+ panelLabel?: string;
43
59
  className?: string;
44
60
  }
45
61
  /** A page with a side menu: a column that keeps the menu's width tokens (open or collapsed, sticky by default) beside the
46
62
  * page, and a drawer for the menu below a breakpoint. The column's width follows collapsed with the collapse motion. */
47
- export declare function KjunSideNavigationLayout({ nav, children, collapsed, onCollapsedChange, railBreakpoint, railLabels, width, sticky, stickyOffset, breakpoint, navOpen, onNavOpenChange, drawerLabel, className }: KjunSideNavigationLayoutProps): import("react/jsx-runtime").JSX.Element;
63
+ export declare function KjunSideNavigationLayout({ nav, children, collapsed, onCollapsedChange, railBreakpoint, railLabels, width, sticky, stickyOffset, breakpoint, navOpen, onNavOpenChange, drawerLabel, spaces, spacesTitle, panelSurface, panelCollapsed, onPanelCollapsedChange, panelLabel, className }: KjunSideNavigationLayoutProps): import("react/jsx-runtime").JSX.Element;
@@ -1,6 +1,8 @@
1
1
  import { type SideNavigationWidth } from "../../../shared/package-runtime/side-navigation.js";
2
2
  import { type ReactNode } from "react";
3
+ import { type SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.js";
3
4
  export type { SideNavigationWidth } from "../../../shared/package-runtime/side-navigation.js";
5
+ export type { SideNavigationPanelSurface } from "../../../shared/package-runtime/side-navigation-layout.js";
4
6
  /** Where the menu is drawn: in the column (collapsed or open) or in the drawer of a narrow screen, which is always open.
5
7
  * closeDrawer closes that drawer, e.g. in the menu's onNavigate; in the column it does nothing. */
6
8
  export type SideNavigationLayoutState = {
@@ -40,8 +42,22 @@ export interface KjunSideNavigationLayoutProps {
40
42
  onNavOpenChange?: (open: boolean) => void;
41
43
  /** The drawer's name for assistive technology; the menu's name by default. */
42
44
  drawerLabel?: string;
45
+ /** A rail of spaces, usually a collapsed KjunSideNavigation, before a menu panel that holds nav. The rail and the panel sit
46
+ * in a band in the navigation-rail-bg colour; the panel's head shows spacesTitle and a collapse button, and below the
47
+ * breakpoint the drawer holds both. With spaces, collapsed, railLabels and width do not apply, and railBreakpoint asks
48
+ * onPanelCollapsedChange instead. A function receives where it is drawn (collapsed is true: the rail is a collapsed menu). */
49
+ spaces?: ReactNode | ((state: SideNavigationLayoutState) => ReactNode);
50
+ /** The chosen space's name at the top of the panel, on one line. */
51
+ spacesTitle?: ReactNode;
52
+ /** The panel: a card set into the band ("card", default) or flat against it with a line before the page ("flat"). */
53
+ panelSurface?: SideNavigationPanelSurface;
54
+ /** The panel is collapsed and only the rail stays; the rail's top cell then holds the expand button. Default false. */
55
+ panelCollapsed?: boolean;
56
+ onPanelCollapsedChange?: (collapsed: boolean) => void;
57
+ /** The panel's name for assistive technology; "메뉴 패널" by default. */
58
+ panelLabel?: string;
43
59
  className?: string;
44
60
  }
45
61
  /** A page with a side menu: a column that keeps the menu's width tokens (open or collapsed, sticky by default) beside the
46
62
  * page, and a drawer for the menu below a breakpoint. The column's width follows collapsed with the collapse motion. */
47
- export declare function KjunSideNavigationLayout({ nav, children, collapsed, onCollapsedChange, railBreakpoint, railLabels, width, sticky, stickyOffset, breakpoint, navOpen, onNavOpenChange, drawerLabel, className }: KjunSideNavigationLayoutProps): import("react/jsx-runtime").JSX.Element;
63
+ export declare function KjunSideNavigationLayout({ nav, children, collapsed, onCollapsedChange, railBreakpoint, railLabels, width, sticky, stickyOffset, breakpoint, navOpen, onNavOpenChange, drawerLabel, spaces, spacesTitle, panelSurface, panelCollapsed, onPanelCollapsedChange, panelLabel, className }: KjunSideNavigationLayoutProps): import("react/jsx-runtime").JSX.Element;
@@ -28,6 +28,8 @@ export interface KjunSplitPaneProps {
28
28
  collapsed?: boolean;
29
29
  defaultCollapsed?: boolean;
30
30
  onCollapsedChange?: (collapsed: boolean) => void;
31
+ /** Hides the second pane and the handle; the first pane takes the whole room and stays mounted, keeping its scroll, selection and focus (a list that opens its detail beside it). second stays mounted too. */
32
+ secondHidden?: boolean;
31
33
  /** Every step of a drag or key press. */
32
34
  onSizeChange?: (size: number) => void;
33
35
  /** Once when a drag ends or a key moves the handle; the place to save the size. */
@@ -40,4 +42,4 @@ export interface KjunSplitPaneProps {
40
42
  id?: string;
41
43
  }
42
44
  /** Two panes with a handle between them; dragging it or pressing arrow keys, Home, End or Enter resizes the first pane. */
43
- export declare function KjunSplitPane({ direction, sizeUnit, size, defaultSize, minSize, maxSize, ariaLabel, disabled, collapsible, collapsedSize, collapsed, defaultCollapsed, onCollapsedChange, onSizeChange, onChangeCommit, first, second, className, style, id }: KjunSplitPaneProps): import("react/jsx-runtime").JSX.Element;
45
+ export declare function KjunSplitPane({ direction, sizeUnit, size, defaultSize, minSize, maxSize, ariaLabel, disabled, collapsible, collapsedSize, collapsed, defaultCollapsed, onCollapsedChange, secondHidden, onSizeChange, onChangeCommit, first, second, className, style, id }: KjunSplitPaneProps): import("react/jsx-runtime").JSX.Element;
@@ -28,6 +28,8 @@ export interface KjunSplitPaneProps {
28
28
  collapsed?: boolean;
29
29
  defaultCollapsed?: boolean;
30
30
  onCollapsedChange?: (collapsed: boolean) => void;
31
+ /** Hides the second pane and the handle; the first pane takes the whole room and stays mounted, keeping its scroll, selection and focus (a list that opens its detail beside it). second stays mounted too. */
32
+ secondHidden?: boolean;
31
33
  /** Every step of a drag or key press. */
32
34
  onSizeChange?: (size: number) => void;
33
35
  /** Once when a drag ends or a key moves the handle; the place to save the size. */
@@ -40,4 +42,4 @@ export interface KjunSplitPaneProps {
40
42
  id?: string;
41
43
  }
42
44
  /** Two panes with a handle between them; dragging it or pressing arrow keys, Home, End or Enter resizes the first pane. */
43
- export declare function KjunSplitPane({ direction, sizeUnit, size, defaultSize, minSize, maxSize, ariaLabel, disabled, collapsible, collapsedSize, collapsed, defaultCollapsed, onCollapsedChange, onSizeChange, onChangeCommit, first, second, className, style, id }: KjunSplitPaneProps): import("react/jsx-runtime").JSX.Element;
45
+ export declare function KjunSplitPane({ direction, sizeUnit, size, defaultSize, minSize, maxSize, ariaLabel, disabled, collapsible, collapsedSize, collapsed, defaultCollapsed, onCollapsedChange, secondHidden, onSizeChange, onChangeCommit, first, second, className, style, id }: KjunSplitPaneProps): import("react/jsx-runtime").JSX.Element;
@@ -4,8 +4,9 @@ export type { KjunStepItem, KjunStepStatus, KjunStepsCurrentStatus, KjunStepsLay
4
4
  export interface KjunStepsProps {
5
5
  /** The steps in order. Two or more. */
6
6
  items: KjunStepItem[];
7
- /** Index of the current step, counted from 0. items.length means every step is complete. */
8
- current: number;
7
+ /** Index of the current step, counted from 0. items.length means every step is complete. Optional when the items carry
8
+ * their own status: the first step marked current or error is then the current one. */
9
+ current?: number;
9
10
  /** error marks the current step as failed (a failed payment, a failed delivery). */
10
11
  currentStatus?: KjunStepsCurrentStatus;
11
12
  orientation?: "horizontal" | "vertical";
@@ -4,8 +4,9 @@ export type { KjunStepItem, KjunStepStatus, KjunStepsCurrentStatus, KjunStepsLay
4
4
  export interface KjunStepsProps {
5
5
  /** The steps in order. Two or more. */
6
6
  items: KjunStepItem[];
7
- /** Index of the current step, counted from 0. items.length means every step is complete. */
8
- current: number;
7
+ /** Index of the current step, counted from 0. items.length means every step is complete. Optional when the items carry
8
+ * their own status: the first step marked current or error is then the current one. */
9
+ current?: number;
9
10
  /** error marks the current step as failed (a failed payment, a failed delivery). */
10
11
  currentStatus?: KjunStepsCurrentStatus;
11
12
  orientation?: "horizontal" | "vertical";
@@ -1,5 +1,5 @@
1
1
  import { type CSSProperties, type KeyboardEvent } from "react";
2
2
  import { type TableGridProps, type TableViewParts } from "../../../shared/package-runtime/table-presentation.cjs";
3
3
  type Props<Row extends object> = TableGridProps<Row, CSSProperties["maxHeight"]> & TableViewParts<Row, KeyboardEvent<HTMLElement>>;
4
- export declare function TableGrid<Row extends object>({ columnGroups, cellSpan, mover, 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, edgeInset, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
4
+ export declare function TableGrid<Row extends object>({ columnGroups, cellSpan, mover, 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, edgeInset, layout, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
5
5
  export {};
@@ -1,5 +1,5 @@
1
1
  import { type CSSProperties, type KeyboardEvent } from "react";
2
2
  import { type TableGridProps, type TableViewParts } from "../../../shared/package-runtime/table-presentation.js";
3
3
  type Props<Row extends object> = TableGridProps<Row, CSSProperties["maxHeight"]> & TableViewParts<Row, KeyboardEvent<HTMLElement>>;
4
- export declare function TableGrid<Row extends object>({ columnGroups, cellSpan, mover, 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, edgeInset, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
4
+ export declare function TableGrid<Row extends object>({ columnGroups, cellSpan, mover, 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, edgeInset, layout, stickyOffset }: Props<Row>): import("react/jsx-runtime").JSX.Element;
5
5
  export {};
@@ -28,3 +28,8 @@ export declare function bottomNavigationLayout(items: readonly {
28
28
  * in (its start first when it is wider than the view). Positions share one axis; a negative result scrolls back.
29
29
  */
30
30
  export declare function revealDelta(itemStart: number, itemEnd: number, viewStart: number, viewEnd: number): number;
31
+ /**
32
+ * Web: how far a floating bar (the capsule, or a floating action bar's content) stands off the screen's bottom edge — its
33
+ * margin in the page flow and, with sticky, its distance from the viewport's bottom while it sticks, so both agree.
34
+ */
35
+ export declare const floatingBarEdge: (offset: number, safeBottom: string) => string;
@@ -28,3 +28,8 @@ export declare function bottomNavigationLayout(items: readonly {
28
28
  * in (its start first when it is wider than the view). Positions share one axis; a negative result scrolls back.
29
29
  */
30
30
  export declare function revealDelta(itemStart: number, itemEnd: number, viewStart: number, viewEnd: number): number;
31
+ /**
32
+ * Web: how far a floating bar (the capsule, or a floating action bar's content) stands off the screen's bottom edge — its
33
+ * margin in the page flow and, with sticky, its distance from the viewport's bottom while it sticks, so both agree.
34
+ */
35
+ export declare const floatingBarEdge: (offset: number, safeBottom: string) => string;
@@ -0,0 +1,17 @@
1
+ /** FormGroup as="fieldset" groups several choice controls under one label. The group's id then goes to one control, so
2
+ * app code can focus the group with document.getElementById(id): the first control that asks for it, skipping disabled
3
+ * ones. Controls ask in mount order, which is their order on the page for the usual static list. */
4
+ export type FormGroupElement = "div" | "fieldset";
5
+ export interface FieldGroupClaim {
6
+ key: string;
7
+ disabled: boolean;
8
+ }
9
+ /** Adds a claim at the end, or updates a held claim in place so it keeps its position. */
10
+ export declare function claimGroupField(claims: readonly FieldGroupClaim[], key: string, disabled: boolean): FieldGroupClaim[];
11
+ export declare function releaseGroupField(claims: readonly FieldGroupClaim[], key: string): FieldGroupClaim[];
12
+ /** The claim that takes the group's id: the first enabled one, or the first one when every control is disabled. */
13
+ export declare function groupFieldOwner(claims: readonly FieldGroupClaim[]): string | undefined;
14
+ /** Index of the option that carries the group's id inside a ButtonGroup or FilterGroup: the first enabled one. */
15
+ export declare function firstEnabledIndex(options: readonly {
16
+ disabled?: boolean;
17
+ }[], groupDisabled?: boolean): number;
@@ -0,0 +1,17 @@
1
+ /** FormGroup as="fieldset" groups several choice controls under one label. The group's id then goes to one control, so
2
+ * app code can focus the group with document.getElementById(id): the first control that asks for it, skipping disabled
3
+ * ones. Controls ask in mount order, which is their order on the page for the usual static list. */
4
+ export type FormGroupElement = "div" | "fieldset";
5
+ export interface FieldGroupClaim {
6
+ key: string;
7
+ disabled: boolean;
8
+ }
9
+ /** Adds a claim at the end, or updates a held claim in place so it keeps its position. */
10
+ export declare function claimGroupField(claims: readonly FieldGroupClaim[], key: string, disabled: boolean): FieldGroupClaim[];
11
+ export declare function releaseGroupField(claims: readonly FieldGroupClaim[], key: string): FieldGroupClaim[];
12
+ /** The claim that takes the group's id: the first enabled one, or the first one when every control is disabled. */
13
+ export declare function groupFieldOwner(claims: readonly FieldGroupClaim[]): string | undefined;
14
+ /** Index of the option that carries the group's id inside a ButtonGroup or FilterGroup: the first enabled one. */
15
+ export declare function firstEnabledIndex(options: readonly {
16
+ disabled?: boolean;
17
+ }[], groupDisabled?: boolean): number;
@@ -133,27 +133,53 @@ export type ListGroupVariant = "inset" | "flush" | "open";
133
133
  /** "details": rows that are read, not pressed, such as "Payment method / Visa": 32 tall, no dividers by default, the
134
134
  * label in the secondary body type and the value in the text color, given the room the label leaves. */
135
135
  export type ListSectionVariant = "default" | "open" | "details";
136
+ /** A section's fill: true paints the surface, false none, "muted" the muted (secondary) fill that sets rows apart inside a white card or modal. */
137
+ export type ListSectionSurface = boolean | "muted";
138
+ /**
139
+ * How a section's fill draws, the same on every platform: whether it paints at all, whether it is the muted fill, and the
140
+ * web data-surface value (none for the plain surface, "false" for no fill, "muted"). On the muted fill a badge takes the
141
+ * plain surface like inside a tinted card, dividers take the border role and an open row's icon square the surface, so
142
+ * none of them dissolves into the fill.
143
+ */
144
+ export declare function listSectionSurface(surface?: ListSectionSurface): {
145
+ painted: boolean;
146
+ muted: boolean;
147
+ attribute: "false" | "muted" | undefined;
148
+ };
136
149
  /** Where a row's trailing value sits: beside the text, on the title line, or on its own line under the title. */
137
150
  export type ListTrailingPosition = "side" | "title" | "below";
138
151
  /**
139
152
  * How a section draws, the same on every platform: whether it is open (rows on the page with no card or dividers; the
140
153
  * section's variant, or the KjunListGroup's) or details (read-only rows; only its own variant), its card corner (the group's when unset; none when open), whether its title
141
154
  * is the small label (a title without a description, unless titleVariant says otherwise) and whether its rows form a card
142
- * with the heading and footer outside it.
155
+ * with the heading and footer outside it. A bleeding section (not an open one, whose rows keep their own inset) is flat: it
156
+ * runs to its container's edge, so it has no corner and keeps its heading and footer with the rows.
143
157
  */
144
- export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant }: {
158
+ export declare function listSectionShape<R extends ListSectionCorner>({ radius, group, variant, title, description, titleVariant, bleed: wantsBleed }: {
145
159
  radius?: R;
146
160
  group?: ListGroupVariant | null;
147
161
  variant?: ListSectionVariant;
148
162
  title?: string;
149
163
  description?: string;
150
164
  titleVariant?: "title" | "label";
165
+ bleed?: boolean;
151
166
  }): {
152
167
  open: boolean;
153
168
  details: boolean;
154
169
  corner: "none" | "lg" | R;
155
170
  bare: boolean;
156
171
  outside: boolean;
172
+ bleed: boolean;
173
+ };
174
+ /**
175
+ * How far a bleeding section reaches past its container and the inset its rows, heading and footer take: the container's
176
+ * own inset (a KjunCard body's padding) when it gives one, otherwise the rows' standard inset, so text keeps to the
177
+ * content line around the section while fills and dividers run to the container's edge. Native reads it; the web
178
+ * stylesheet does the same with the card's --_kjun-card-body-padding.
179
+ */
180
+ export declare function listSectionInset(bleed: boolean, containerInset: number | null | undefined, rowInset: number): {
181
+ inset: number;
182
+ margin: number;
157
183
  };
158
184
  /**
159
185
  * Web heading actions: records the tallest action's height on the heading, so any control (not only a KjunButton, which