@manakind/ui-core 0.39.0 → 0.40.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.
@@ -6,9 +6,11 @@
6
6
  gap: var(--ds-radio-group-gap);
7
7
  overflow-wrap: anywhere;
8
8
 
9
+ /* Field's label, as every control a form names; the choices keep the group's own size. */
9
10
  & .ds-radio-group__label {
10
- color: var(--ds-radio-group-label-text);
11
- font-size: var(--ds-radio-group-label-font-size);
11
+ color: var(--ds-field-label-text);
12
+ font-size: var(--ds-field-label-font-size);
13
+ font-weight: var(--ds-field-label-font-weight);
12
14
  }
13
15
 
14
16
  /*
@@ -133,4 +135,68 @@
133
135
  justify-content: center;
134
136
  }
135
137
  }
138
+
139
+ /*
140
+ * Chips: the label above a row of chips that wraps. Each chip is the whole
141
+ * click target; the hidden radio inside it carries the state and the
142
+ * keyboard. Chosen, the chip fills with the primary's tint and its border
143
+ * takes a step of the primary that clears 3:1 on the surface around it;
144
+ * keyboard focus is the focus ring drawn outside it.
145
+ */
146
+ .ds-radio-group--chips {
147
+ & .ds-radio-group__chips {
148
+ display: flex;
149
+ flex-wrap: wrap;
150
+ gap: var(--ds-radio-group-chip-gap);
151
+ max-width: 100%;
152
+ }
153
+
154
+ & .ds-radio-group__item {
155
+ box-sizing: border-box;
156
+ display: inline-flex;
157
+ align-items: center;
158
+ padding: var(--ds-radio-group-chip-padding-block) var(--ds-radio-group-chip-padding-inline);
159
+ border: 1px solid var(--ds-radio-group-chip-border);
160
+ border-radius: var(--ds-radio-group-chip-radius);
161
+ background-color: var(--ds-radio-group-chip-bg);
162
+ color: var(--ds-radio-group-chip-text);
163
+ font-size: var(--ds-radio-group-chip-font-size);
164
+ transition:
165
+ background-color 150ms cubic-bezier(0, 0, 0.2, 1),
166
+ border-color 150ms cubic-bezier(0, 0, 0.2, 1),
167
+ color 150ms cubic-bezier(0, 0, 0.2, 1);
168
+
169
+ &[data-hover]:not([data-disabled], [data-state="checked"]) {
170
+ border-color: var(--ds-radio-group-chip-border-hover);
171
+ }
172
+
173
+ &[data-state="checked"] {
174
+ border-color: var(--ds-radio-group-chip-border-checked);
175
+ background-color: var(--ds-radio-group-chip-bg-checked);
176
+ color: var(--ds-radio-group-chip-text-checked);
177
+ }
178
+
179
+ &[data-focus-visible] {
180
+ outline: 2px solid var(--ds-radio-group-focus-ring);
181
+ outline-offset: 2px;
182
+ }
183
+
184
+ &[data-disabled] {
185
+ opacity: var(--ds-opacity-disabled);
186
+ }
187
+ }
188
+ }
189
+
190
+ /*
191
+ * Forced colours paint every chip in the same system colours, so the tint
192
+ * that marks the chosen one vanishes. Its border thickens instead, as a
193
+ * chosen card's does, and the padding gives back what it takes.
194
+ */
195
+ @media (forced-colors: active) {
196
+ .ds-radio-group--chips .ds-radio-group__item[data-state="checked"] {
197
+ border-width: 2px;
198
+ padding: calc(var(--ds-radio-group-chip-padding-block) - 1px)
199
+ calc(var(--ds-radio-group-chip-padding-inline) - 1px);
200
+ }
201
+ }
136
202
  }
@@ -9,7 +9,8 @@ export interface RadioGroupItem {
9
9
  * A sentence under the label saying what the choice means, in the muted
10
10
  * hint text of a Field. The radio's accessible description; its name
11
11
  * stays the label alone. A list group shows it; a cards group, which
12
- * shows `visual` instead, ignores it.
12
+ * shows `visual` instead, and a chips group, which shows the label
13
+ * alone, ignore it.
13
14
  */
14
15
  description?: string;
15
16
  /** Individually disable this choice without removing it. */
@@ -17,12 +18,16 @@ export interface RadioGroupItem {
17
18
  /**
18
19
  * A picture of the choice, above its label on a `cards` group: a swatch,
19
20
  * a badge, a preview. Decorative: the label names the choice. A `list`
20
- * group ignores it.
21
+ * or `chips` group ignores it.
21
22
  */
22
23
  visual?: ReactNode;
23
24
  }
24
- /** `list` (default) sets radios one under the other; `cards` sets each choice on a card in a wrapping grid. */
25
- export type RadioGroupAppearance = 'list' | 'cards';
25
+ /**
26
+ * `list` (default) sets radios one under the other; `cards` sets each choice
27
+ * on a card in a wrapping grid; `chips` sets each choice on a chip in a
28
+ * wrapping row.
29
+ */
30
+ export type RadioGroupAppearance = 'list' | 'cards' | 'chips';
26
31
  /**
27
32
  * A radio group has to have a name, expressed as a union so an unnamed group
28
33
  * is a compile error rather than an axe finding, as `SegmentGroup` does.
@@ -48,7 +53,9 @@ export type RadioGroupProps = RadioGroupName & {
48
53
  * `cards` sets each choice on a card, its `visual` above its label, in a
49
54
  * grid that fills the width and wraps; the chosen card carries a heavier
50
55
  * ring instead of a radio. For choices told apart by how they look, such
51
- * as colours or themes.
56
+ * as colours or themes. `chips` sets each label on a chip, in a row that
57
+ * wraps; the chosen chip fills with the primary's tint instead of a radio.
58
+ * For a few short choices in a form, read at a glance.
52
59
  */
53
60
  appearance?: RadioGroupAppearance;
54
61
  /**
@@ -114,9 +121,10 @@ export type RadioGroupProps = RadioGroupName & {
114
121
  * ```
115
122
  *
116
123
  * Choices told apart by how they look (a colour, a theme) take
117
- * `appearance="cards"`, each with a `visual`. A few short choices seen at
118
- * once in a row are a `SegmentGroup`; a long list, or one in a form row, is
119
- * a `Select`.
124
+ * `appearance="cards"`, each with a `visual`. A few short choices in a
125
+ * form, whose labels may run to several words, take `appearance="chips"`.
126
+ * A few short choices that switch a view are a `SegmentGroup`; a long list
127
+ * is a `Select`.
120
128
  */
121
129
  export declare function RadioGroup({ label, items, value, defaultValue, onValueChange, disabled, name, appearance, className, 'aria-label': ariaLabel, }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;
122
130
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAI3B,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,+GAA+G;AAC/G,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD;;;GAGG;AACH,KAAK,cAAc,GACf;IACE,0DAA0D;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,6BAA6B;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAmB,EACnB,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,eAAe,2CAkEjB"}
1
+ {"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAI3B,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D;;;GAGG;AACH,KAAK,cAAc,GACf;IACE,0DAA0D;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,6BAA6B;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAmB,EACnB,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,eAAe,2CAqEjB"}
@@ -51,12 +51,14 @@ import { cx } from '../cx';
51
51
  * ```
52
52
  *
53
53
  * Choices told apart by how they look (a colour, a theme) take
54
- * `appearance="cards"`, each with a `visual`. A few short choices seen at
55
- * once in a row are a `SegmentGroup`; a long list, or one in a form row, is
56
- * a `Select`.
54
+ * `appearance="cards"`, each with a `visual`. A few short choices in a
55
+ * form, whose labels may run to several words, take `appearance="chips"`.
56
+ * A few short choices that switch a view are a `SegmentGroup`; a long list
57
+ * is a `Select`.
57
58
  */
58
59
  export function RadioGroup({ label, items, value, defaultValue, onValueChange, disabled, name, appearance = 'list', className, 'aria-label': ariaLabel, }) {
59
60
  const cards = appearance === 'cards';
61
+ const list = appearance === 'list';
60
62
  const rootRef = useRef(null);
61
63
  const descriptionId = useId();
62
64
  const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);
@@ -65,12 +67,17 @@ export function RadioGroup({ label, items, value, defaultValue, onValueChange, d
65
67
  ariaLabel,
66
68
  className: 'ds-radio-group__label',
67
69
  });
68
- const marker = (item) => cards ? (_jsx("span", { className: "ds-radio-group__visual", "aria-hidden": true, children: item.visual })) : (_jsx(ArkRadioGroup.ItemControl, { className: "ds-radio-group__control" }));
70
+ const marker = (item) => {
71
+ if (cards) {
72
+ return (_jsx("span", { className: "ds-radio-group__visual", "aria-hidden": true, children: item.visual }));
73
+ }
74
+ return list ? _jsx(ArkRadioGroup.ItemControl, { className: "ds-radio-group__control" }) : null;
75
+ };
69
76
  const renderItem = (item, index) => {
70
- const describedBy = !cards && item.description ? `${descriptionId}-${index}` : undefined;
77
+ const describedBy = list && item.description ? `${descriptionId}-${index}` : undefined;
71
78
  return (_jsxs(ArkRadioGroup.Item, { value: item.value, disabled: item.disabled, className: "ds-radio-group__item", children: [marker(item), _jsx(ArkRadioGroup.ItemText, { className: "ds-radio-group__text", children: item.label }), describedBy && (_jsx("span", { id: describedBy, className: "ds-radio-group__description", children: item.description })), _jsx(ArkRadioGroup.ItemHiddenInput, { "aria-describedby": describedBy })] }, item.value));
72
79
  };
73
- const choices = cards ? (_jsx("div", { className: "ds-radio-group__cards", children: items.map(renderItem) })) : (items.map(renderItem));
74
- return (_jsxs(ArkRadioGroup.Root, { ref: rootRef, className: cx('ds-radio-group', cards && 'ds-radio-group--cards', className), value: value, defaultValue: defaultValue, onValueChange: handleValueChange, disabled: disabled, name: name, orientation: "vertical", "aria-label": ariaLabel, children: [visibleLabel, choices] }));
80
+ const choices = list ? (items.map(renderItem)) : (_jsx("div", { className: `ds-radio-group__${appearance}`, children: items.map(renderItem) }));
81
+ return (_jsxs(ArkRadioGroup.Root, { ref: rootRef, className: cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className), value: value, defaultValue: defaultValue, onValueChange: handleValueChange, disabled: disabled, name: name, orientation: "vertical", "aria-label": ariaLabel, children: [visibleLabel, choices] }));
75
82
  }
76
83
  //# sourceMappingURL=radio-group.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"radio-group.js","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAkB,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AA2E3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAU,GAAG,MAAM,EACnB,SAAS,EACT,YAAY,EAAE,SAAS,GACP;IAChB,MAAM,KAAK,GAAG,UAAU,KAAK,OAAO,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,KAAK,EAAE,CAAC;IAE9B,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAEjF,MAAM,YAAY,GAAG,kBAAkB,CAAC,aAAa,CAAC,KAAK,EAAE;QAC3D,KAAK;QACL,SAAS;QACT,SAAS,EAAE,uBAAuB;KACnC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,IAAoB,EAAE,EAAE,CACtC,KAAK,CAAC,CAAC,CAAC,CACN,eAAM,SAAS,EAAC,wBAAwB,iCACrC,IAAI,CAAC,MAAM,GACP,CACR,CAAC,CAAC,CAAC,CACF,KAAC,aAAa,CAAC,WAAW,IAAC,SAAS,EAAC,yBAAyB,GAAG,CAClE,CAAC;IACJ,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,KAAa,EAAE,EAAE;QACzD,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,OAAO,CACL,MAAC,aAAa,CAAC,IAAI,IAEjB,KAAK,EAAE,IAAI,CAAC,KAAK,EACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EACvB,SAAS,EAAC,sBAAsB,aAE/B,MAAM,CAAC,IAAI,CAAC,EACb,KAAC,aAAa,CAAC,QAAQ,IAAC,SAAS,EAAC,sBAAsB,YACrD,IAAI,CAAC,KAAK,GACY,EACxB,WAAW,IAAI,CACd,eAAM,EAAE,EAAE,WAAW,EAAE,SAAS,EAAC,6BAA6B,YAC3D,IAAI,CAAC,WAAW,GACZ,CACR,EACD,KAAC,aAAa,CAAC,eAAe,wBAAmB,WAAW,GAAI,KAd3D,IAAI,CAAC,KAAK,CAeI,CACtB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CACtB,cAAK,SAAS,EAAC,uBAAuB,YAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAO,CACrE,CAAC,CAAC,CAAC,CACF,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CACtB,CAAC;IAEF,OAAO,CACL,MAAC,aAAa,CAAC,IAAI,IACjB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,KAAK,IAAI,uBAAuB,EAAE,SAAS,CAAC,EAC5E,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,iBAAiB,EAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,WAAW,EAAC,UAAU,gBACV,SAAS,aAEpB,YAAY,EACZ,OAAO,IACW,CACtB,CAAC;AACJ,CAAC","sourcesContent":["import { RadioGroup as ArkRadioGroup } from '@ark-ui/react/radio-group';\nimport { type ReactNode, useId, useRef } from 'react';\nimport './radio-group.css';\nimport { radioGroupChangeHandler, renderVisibleLabel } from '../ark-native-input';\nimport { cx } from '../cx';\n\nexport interface RadioGroupItem {\n /** Stable value reported by `onValueChange` and compared with `value`. */\n value: string;\n /** Text beside the radio. The whole row is its click target. */\n label: string;\n /**\n * A sentence under the label saying what the choice means, in the muted\n * hint text of a Field. The radio's accessible description; its name\n * stays the label alone. A list group shows it; a cards group, which\n * shows `visual` instead, ignores it.\n */\n description?: string;\n /** Individually disable this choice without removing it. */\n disabled?: boolean;\n /**\n * A picture of the choice, above its label on a `cards` group: a swatch,\n * a badge, a preview. Decorative: the label names the choice. A `list`\n * group ignores it.\n */\n visual?: ReactNode;\n}\n\n/** `list` (default) sets radios one under the other; `cards` sets each choice on a card in a wrapping grid. */\nexport type RadioGroupAppearance = 'list' | 'cards';\n\n/**\n * A radio group has to have a name, expressed as a union so an unnamed group\n * is a compile error rather than an axe finding, as `SegmentGroup` does.\n */\ntype RadioGroupName =\n | {\n /** Visible label, above the choices, naming the group. */\n label: ReactNode;\n /**\n * A different accessible name when the visible label alone would not\n * say what the choice is. Keep the visible words in it.\n */\n 'aria-label'?: string;\n }\n | {\n label?: undefined;\n /** Accessible name when a heading or a section title around it already says what the choice is. */\n 'aria-label': string;\n };\n\nexport type RadioGroupProps = RadioGroupName & {\n /** The choices, in order. */\n items: RadioGroupItem[];\n /**\n * `list` (default) sets a radio beside each label, one under the other.\n * `cards` sets each choice on a card, its `visual` above its label, in a\n * grid that fills the width and wraps; the chosen card carries a heavier\n * ring instead of a radio. For choices told apart by how they look, such\n * as colours or themes.\n */\n appearance?: RadioGroupAppearance;\n /**\n * Controlled value. `null` is controlled with nothing chosen; `undefined`\n * leaves the component to own its value from `defaultValue` onward.\n */\n value?: string | null;\n /** Initial value when uncontrolled. */\n defaultValue?: string;\n /** Fired with the newly chosen value. Choosing the chosen one again does nothing. */\n onValueChange?: (value: string) => void;\n /** Disable every choice. The chosen one keeps showing which is set. */\n disabled?: boolean;\n /** Name for native form participation through the radio inputs. */\n name?: string;\n /** Extra class names appended after `ds-radio-group`. */\n className?: string;\n};\n\n/**\n * One choice among several, as a column of radios, built on Ark UI's\n * RadioGroup: a filter's period, a setting with a handful of options whose\n * labels are worth reading side by side.\n *\n * Ark owns the behaviour: native radio inputs carry the state, the arrow keys\n * move the choice and Tab leaves the group in one step. This wrapper\n * contributes `ds-` classes, the `--ds-radio-group-*` bindings and a flat\n * `items` API.\n *\n * ```tsx\n * <RadioGroup\n * aria-label=\"Scheduled in\"\n * items={[\n * { value: 'any', label: 'Any time' },\n * { value: 'this-week', label: 'This week' },\n * ]}\n * value={when}\n * onValueChange={setWhen}\n * />\n * ```\n *\n * A choice whose label alone would not say what it does takes a\n * `description`, a sentence set under the label and read as the radio's\n * description:\n *\n * ```tsx\n * <RadioGroup\n * label=\"Completing a task\"\n * items={[\n * {\n * value: 'archive',\n * label: 'Archive',\n * description: 'Done tasks leave the list and stay searchable.',\n * },\n * {\n * value: 'keep',\n * label: 'Keep in place',\n * description: 'Done tasks stay where they are, struck through.',\n * },\n * ]}\n * value={mode}\n * onValueChange={setMode}\n * />\n * ```\n *\n * Choices told apart by how they look (a colour, a theme) take\n * `appearance=\"cards\"`, each with a `visual`. A few short choices seen at\n * once in a row are a `SegmentGroup`; a long list, or one in a form row, is\n * a `Select`.\n */\nexport function RadioGroup({\n label,\n items,\n value,\n defaultValue,\n onValueChange,\n disabled,\n name,\n appearance = 'list',\n className,\n 'aria-label': ariaLabel,\n}: RadioGroupProps) {\n const cards = appearance === 'cards';\n const rootRef = useRef<HTMLDivElement>(null);\n const descriptionId = useId();\n\n const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);\n\n const visibleLabel = renderVisibleLabel(ArkRadioGroup.Label, {\n label,\n ariaLabel,\n className: 'ds-radio-group__label',\n });\n\n const marker = (item: RadioGroupItem) =>\n cards ? (\n <span className=\"ds-radio-group__visual\" aria-hidden>\n {item.visual}\n </span>\n ) : (\n <ArkRadioGroup.ItemControl className=\"ds-radio-group__control\" />\n );\n const renderItem = (item: RadioGroupItem, index: number) => {\n const describedBy = !cards && item.description ? `${descriptionId}-${index}` : undefined;\n return (\n <ArkRadioGroup.Item\n key={item.value}\n value={item.value}\n disabled={item.disabled}\n className=\"ds-radio-group__item\"\n >\n {marker(item)}\n <ArkRadioGroup.ItemText className=\"ds-radio-group__text\">\n {item.label}\n </ArkRadioGroup.ItemText>\n {describedBy && (\n <span id={describedBy} className=\"ds-radio-group__description\">\n {item.description}\n </span>\n )}\n <ArkRadioGroup.ItemHiddenInput aria-describedby={describedBy} />\n </ArkRadioGroup.Item>\n );\n };\n\n const choices = cards ? (\n <div className=\"ds-radio-group__cards\">{items.map(renderItem)}</div>\n ) : (\n items.map(renderItem)\n );\n\n return (\n <ArkRadioGroup.Root\n ref={rootRef}\n className={cx('ds-radio-group', cards && 'ds-radio-group--cards', className)}\n value={value}\n defaultValue={defaultValue}\n onValueChange={handleValueChange}\n disabled={disabled}\n name={name}\n orientation=\"vertical\"\n aria-label={ariaLabel}\n >\n {visibleLabel}\n {choices}\n </ArkRadioGroup.Root>\n );\n}\n"]}
1
+ {"version":3,"file":"radio-group.js","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"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","sourcesContent":["import { RadioGroup as ArkRadioGroup } from '@ark-ui/react/radio-group';\nimport { type ReactNode, useId, useRef } from 'react';\nimport './radio-group.css';\nimport { radioGroupChangeHandler, renderVisibleLabel } from '../ark-native-input';\nimport { cx } from '../cx';\n\nexport interface RadioGroupItem {\n /** Stable value reported by `onValueChange` and compared with `value`. */\n value: string;\n /** Text beside the radio. The whole row is its click target. */\n label: string;\n /**\n * A sentence under the label saying what the choice means, in the muted\n * hint text of a Field. The radio's accessible description; its name\n * stays the label alone. A list group shows it; a cards group, which\n * shows `visual` instead, and a chips group, which shows the label\n * alone, ignore it.\n */\n description?: string;\n /** Individually disable this choice without removing it. */\n disabled?: boolean;\n /**\n * A picture of the choice, above its label on a `cards` group: a swatch,\n * a badge, a preview. Decorative: the label names the choice. A `list`\n * or `chips` group ignores it.\n */\n visual?: ReactNode;\n}\n\n/**\n * `list` (default) sets radios one under the other; `cards` sets each choice\n * on a card in a wrapping grid; `chips` sets each choice on a chip in a\n * wrapping row.\n */\nexport type RadioGroupAppearance = 'list' | 'cards' | 'chips';\n\n/**\n * A radio group has to have a name, expressed as a union so an unnamed group\n * is a compile error rather than an axe finding, as `SegmentGroup` does.\n */\ntype RadioGroupName =\n | {\n /** Visible label, above the choices, naming the group. */\n label: ReactNode;\n /**\n * A different accessible name when the visible label alone would not\n * say what the choice is. Keep the visible words in it.\n */\n 'aria-label'?: string;\n }\n | {\n label?: undefined;\n /** Accessible name when a heading or a section title around it already says what the choice is. */\n 'aria-label': string;\n };\n\nexport type RadioGroupProps = RadioGroupName & {\n /** The choices, in order. */\n items: RadioGroupItem[];\n /**\n * `list` (default) sets a radio beside each label, one under the other.\n * `cards` sets each choice on a card, its `visual` above its label, in a\n * grid that fills the width and wraps; the chosen card carries a heavier\n * ring instead of a radio. For choices told apart by how they look, such\n * as colours or themes. `chips` sets each label on a chip, in a row that\n * wraps; the chosen chip fills with the primary's tint instead of a radio.\n * For a few short choices in a form, read at a glance.\n */\n appearance?: RadioGroupAppearance;\n /**\n * Controlled value. `null` is controlled with nothing chosen; `undefined`\n * leaves the component to own its value from `defaultValue` onward.\n */\n value?: string | null;\n /** Initial value when uncontrolled. */\n defaultValue?: string;\n /** Fired with the newly chosen value. Choosing the chosen one again does nothing. */\n onValueChange?: (value: string) => void;\n /** Disable every choice. The chosen one keeps showing which is set. */\n disabled?: boolean;\n /** Name for native form participation through the radio inputs. */\n name?: string;\n /** Extra class names appended after `ds-radio-group`. */\n className?: string;\n};\n\n/**\n * One choice among several, as a column of radios, built on Ark UI's\n * RadioGroup: a filter's period, a setting with a handful of options whose\n * labels are worth reading side by side.\n *\n * Ark owns the behaviour: native radio inputs carry the state, the arrow keys\n * move the choice and Tab leaves the group in one step. This wrapper\n * contributes `ds-` classes, the `--ds-radio-group-*` bindings and a flat\n * `items` API.\n *\n * ```tsx\n * <RadioGroup\n * aria-label=\"Scheduled in\"\n * items={[\n * { value: 'any', label: 'Any time' },\n * { value: 'this-week', label: 'This week' },\n * ]}\n * value={when}\n * onValueChange={setWhen}\n * />\n * ```\n *\n * A choice whose label alone would not say what it does takes a\n * `description`, a sentence set under the label and read as the radio's\n * description:\n *\n * ```tsx\n * <RadioGroup\n * label=\"Completing a task\"\n * items={[\n * {\n * value: 'archive',\n * label: 'Archive',\n * description: 'Done tasks leave the list and stay searchable.',\n * },\n * {\n * value: 'keep',\n * label: 'Keep in place',\n * description: 'Done tasks stay where they are, struck through.',\n * },\n * ]}\n * value={mode}\n * onValueChange={setMode}\n * />\n * ```\n *\n * Choices told apart by how they look (a colour, a theme) take\n * `appearance=\"cards\"`, each with a `visual`. A few short choices in a\n * form, whose labels may run to several words, take `appearance=\"chips\"`.\n * A few short choices that switch a view are a `SegmentGroup`; a long list\n * is a `Select`.\n */\nexport function RadioGroup({\n label,\n items,\n value,\n defaultValue,\n onValueChange,\n disabled,\n name,\n appearance = 'list',\n className,\n 'aria-label': ariaLabel,\n}: RadioGroupProps) {\n const cards = appearance === 'cards';\n const list = appearance === 'list';\n const rootRef = useRef<HTMLDivElement>(null);\n const descriptionId = useId();\n\n const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);\n\n const visibleLabel = renderVisibleLabel(ArkRadioGroup.Label, {\n label,\n ariaLabel,\n className: 'ds-radio-group__label',\n });\n\n const marker = (item: RadioGroupItem) => {\n if (cards) {\n return (\n <span className=\"ds-radio-group__visual\" aria-hidden>\n {item.visual}\n </span>\n );\n }\n return list ? <ArkRadioGroup.ItemControl className=\"ds-radio-group__control\" /> : null;\n };\n const renderItem = (item: RadioGroupItem, index: number) => {\n const describedBy = list && item.description ? `${descriptionId}-${index}` : undefined;\n return (\n <ArkRadioGroup.Item\n key={item.value}\n value={item.value}\n disabled={item.disabled}\n className=\"ds-radio-group__item\"\n >\n {marker(item)}\n <ArkRadioGroup.ItemText className=\"ds-radio-group__text\">\n {item.label}\n </ArkRadioGroup.ItemText>\n {describedBy && (\n <span id={describedBy} className=\"ds-radio-group__description\">\n {item.description}\n </span>\n )}\n <ArkRadioGroup.ItemHiddenInput aria-describedby={describedBy} />\n </ArkRadioGroup.Item>\n );\n };\n\n const choices = list ? (\n items.map(renderItem)\n ) : (\n <div className={`ds-radio-group__${appearance}`}>{items.map(renderItem)}</div>\n );\n\n return (\n <ArkRadioGroup.Root\n ref={rootRef}\n className={cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className)}\n value={value}\n defaultValue={defaultValue}\n onValueChange={handleValueChange}\n disabled={disabled}\n name={name}\n orientation=\"vertical\"\n aria-label={ariaLabel}\n >\n {visibleLabel}\n {choices}\n </ArkRadioGroup.Root>\n );\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@manakind/ui-core",
3
- "version": "0.39.0",
3
+ "version": "0.40.0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -420,7 +420,7 @@
420
420
  },
421
421
  "devDependencies": {
422
422
  "@manakind/ds-config": "*",
423
- "@manakind/manuia-tokens": "0.37.0",
423
+ "@manakind/manuia-tokens": "0.38.0",
424
424
  "@testing-library/jest-dom": "^6.9.1",
425
425
  "@testing-library/react": "^16.3.2",
426
426
  "@testing-library/user-event": "^14.6.1",