@react-hive/honey-layout 17.7.0 → 17.9.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.
@@ -9,4 +9,4 @@ export interface HoneyContextMenuProps<Option extends HoneyContextMenuOption<Con
9
9
  children: ReactNode | ((context: HoneyPopupContextValue<Context, Reference>) => ReactNode);
10
10
  subProps?: FastOmit<HoneyContextMenuContentProps<Option, Context, Reference, UseAutoSize>, 'options' | 'optionProps'>;
11
11
  }
12
- export declare const HoneyContextMenu: <Option extends HoneyContextMenuOption<Context, Reference>, Context, Reference extends ReferenceType, UseAutoSize extends boolean>({ children, subProps, options, optionProps, clickOptions, context, ...popupProps }: HoneyContextMenuProps<Option, Context, Reference, UseAutoSize>) => React.JSX.Element;
12
+ export declare const HoneyContextMenu: <Option extends HoneyContextMenuOption<Context, Reference>, Context = undefined, Reference extends ReferenceType = ReferenceType, UseAutoSize extends boolean = false>({ children, subProps, options, optionProps, roleOptions, context, ...popupProps }: HoneyContextMenuProps<Option, Context, Reference, UseAutoSize>) => React.JSX.Element;
@@ -7,28 +7,31 @@ export type HoneyFlexProps<Element extends ElementType = 'div'> = HoneyBoxProps<
7
7
  * When enabled, this prop applies:
8
8
  * - `display: inline-flex`
9
9
  *
10
- * When disabled (default), the layout uses:
11
- * - `display: flex`
10
+ * When disabled, the layout uses:
11
+ * - `$display`, when explicitly provided
12
+ * - otherwise `display: flex`
12
13
  *
13
14
  * This is a semantic convenience prop intended for inline alignment scenarios
14
15
  * (e.g. buttons, badges, form controls).
15
16
  *
16
- * If `$display` is explicitly provided, it always takes precedence over this prop.
17
+ * `inline` takes precedence over `$display`.
17
18
  *
18
19
  * @default false
19
20
  */
20
21
  inline?: boolean;
21
22
  /**
22
- * Enables horizontal (row-based) layout.
23
+ * Enables horizontal row-based layout.
23
24
  *
24
25
  * When enabled, this prop applies:
25
26
  * - `flex-direction: row`
26
27
  *
27
- * When disabled (default), the layout uses:
28
- * - `flex-direction: column`
28
+ * When disabled, the layout uses:
29
+ * - `$flexDirection`, when explicitly provided
30
+ * - otherwise `flex-direction: column`
29
31
  *
30
- * This is a semantic convenience prop. If `$flexDirection` is explicitly provided,
31
- * it will always take precedence.
32
+ * This is a semantic convenience prop.
33
+ *
34
+ * `$flexDirection` takes precedence over `row`.
32
35
  *
33
36
  * @default false
34
37
  */
@@ -52,8 +55,8 @@ export type HoneyFlexProps<Element extends ElementType = 'div'> = HoneyBoxProps<
52
55
  /**
53
56
  * Centers children along the horizontal axis.
54
57
  *
55
- * - In column layouts: maps to `align-items: center`
56
- * - In row layouts: maps to `justify-content: center`
58
+ * - In column and column-reverse layouts: maps to `align-items: center`
59
+ * - In row and row-reverse layouts: maps to `justify-content: center`
57
60
  *
58
61
  * Ignored if `center` is enabled or if the corresponding explicit style prop is provided.
59
62
  *
@@ -63,8 +66,8 @@ export type HoneyFlexProps<Element extends ElementType = 'div'> = HoneyBoxProps<
63
66
  /**
64
67
  * Centers children along the vertical axis.
65
68
  *
66
- * - In column layouts: maps to `justify-content: center`
67
- * - In row layouts: maps to `align-items: center`
69
+ * - In column and column-reverse layouts: maps to `justify-content: center`
70
+ * - In row and row-reverse layouts: maps to `align-items: center`
68
71
  *
69
72
  * Ignored if `center` is enabled or if the corresponding explicit style prop is provided.
70
73
  *
@@ -94,7 +97,11 @@ export type HoneyFlexProps<Element extends ElementType = 'div'> = HoneyBoxProps<
94
97
  * - `centerX`, `centerY` → axis-aware centering helpers
95
98
  *
96
99
  * Semantic helpers exist purely for convenience and readability.
97
- * Any explicitly provided style props **always take precedence**.
100
+ *
101
+ * Precedence rules:
102
+ * - `inline` takes precedence over `$display`
103
+ * - `$flexDirection` takes precedence over `row`
104
+ * - `$alignItems` and `$justifyContent` take precedence over centering helpers
98
105
  *
99
106
  * ---
100
107
  *
@@ -115,7 +122,7 @@ export type HoneyFlexProps<Element extends ElementType = 'div'> = HoneyBoxProps<
115
122
  *
116
123
  * @example Horizontal layout
117
124
  * ```tsx
118
- * <HoneyFlex $gap={2} row/>
125
+ * <HoneyFlex $gap={2} row />
119
126
  * ```
120
127
  *
121
128
  * @example Column layout