@donkit-ai/design-system 0.2.18 → 0.2.19

package/README.md

@@ -37,13 +37,16 @@ npm install @donkit-ai/design-system@latest
 
 ## Компоненты
 
-- **Button** - кнопки с вариантами (primary, secondary, ghost) и размерами (small, medium, large). Поддерживает `href` для рендера как ссылка
-- **Tabs** - вкладки с состоянием selected в трех размерах (small, medium, large). Поддерживает `href` для рендера как ссылка
-- **Input** - текстовые поля с поддержкой иконок, ошибок и подсказок (small, medium)
-- **Stepper** - числовое поле с кнопками +/- для изменения значения (small, medium)
+- **Button** - кнопки с вариантами (primary, secondary, ghost) и размерами (xs, small, medium, large). Поддерживает `href` для рендера как ссылка
+- **Tabs** - вкладки с состоянием selected в четырех размерах (xs, small, medium, large). Поддерживает `href` для рендера как ссылка
+- **Input** - текстовые поля с поддержкой иконок, ошибок и подсказок (xs, small, medium)
+- **Textarea** - многострочное текстовое поле (xs, small, medium)
+- **Select** - выпадающий список с кастомным дизайном (xs, small, medium)
+- **Stepper** - числовое поле с кнопками +/- для изменения значения (xs, small, medium)
 - **Toggle** - переключатель для включения/выключения опций (xs, small, medium, large)
 - **Checkbox** - чекбокс для выбора опций (xs, small, medium, large)
-- **Card** - карточки двух типов: info (информационная, прозрачный фон) и interactive (интерактивная с hover эффектом)
+- **Radio** - радиокнопка для выбора одного варианта из группы (xs, small, medium, large)
+- **Card** - карточки двух типов: info (информационная, прозрачный фон) и interactive (интерактивная с hover эффектом). Поддерживает `href` для рендера как ссылка
 - **Typography** - H1-H4, P1-P3 компоненты
 - **Code** - inline и block код с monospace шрифтом
 - **Link** - ссылки акцентным цветом, при hover цвет меняется и появляется подчеркивание
@@ -113,20 +116,25 @@ import { iconSizes } from '@donkit-ai/design-system';
 **Соответствие размеров компонентам:**
 
 - **16px (xs)** - очень мелкие элементы
+  - Extra Small кнопки (`size="xs"`)
+  - Extra Small табы (`size="xs"`)
+
 - **20px (s)** - компактные элементы
   - Small кнопки (`size="small"`)
-  - Tabs (вкладки)
+  - Small табы (`size="small"`)
   - Modal (иконка закрытия)
   - Accordion, CodeAccordion
 
 - **24px (m)** - стандартные элементы
   - Medium кнопки (`size="medium"`, по умолчанию)
+  - Medium табы (`size="medium"`)
   - Input (иконки в полях ввода)
   - Alert (иконки статусов)
   - Select (иконка выпадающего списка)
 
 - **28px (l)** - крупные элементы
   - Large кнопки (`size="large"`)
+  - Large табы (`size="large"`)
 
 - **48px (xl)** - очень крупные элементы
 
@@ -334,6 +342,9 @@ document.documentElement.setAttribute('data-theme', 'light');
 <Button variant="ghost">Ghost</Button>
 
 // Размеры с соответствующими иконками
+<Button size="xs" icon={<Mail size={16} strokeWidth={1.5} />}>
+  Extra Small
+</Button>
 <Button size="small" icon={<Mail size={20} strokeWidth={1.5} />}>
   Small
 </Button>
@@ -376,7 +387,8 @@ import { AlertCircle } from 'lucide-react';
   </Tab>
 </Tabs>
 
-// With icons (всегда 20px для Tabs)
+// With icons (размер иконки соответствует размеру таба)
+// xs: 16px, small: 20px, medium: 24px, large: 28px
 <Tabs size="small">
   <Tab
     selected={selectedTab === 'alerts'}
@@ -417,7 +429,7 @@ import { AlertCircle } from 'lucide-react';
 - Hover: фон `--color-item-bg-hover`, текст `--color-txt-icon-1`
 - Default: текст `--color-txt-icon-2`
 
-**Размеры:** small, medium, large
+**Размеры:** xs, small, medium, large
 
 **Дополнительно:** поддержка иконок и disabled состояния
 
@@ -709,6 +721,129 @@ import { AlertCircle } from 'lucide-react';
 - Невыбранное состояние: фон `--color-item-bg`, border `--color-border`, hover `--color-border-hover`
 - Иконка галочки (Check) белого цвета при checked
 
+### Radio
+
+Радиокнопка для выбора одного варианта из группы. Размеры привязаны к размерам иконок.
+
+```jsx
+// Basic radio
+<Radio
+  checked={selectedOption === 'option1'}
+  onChange={() => setSelectedOption('option1')}
+  name="options"
+  value="option1"
+  label="Option 1"
+/>
+
+// Extra Small size (16px)
+<Radio
+  size="xs"
+  checked={size === 'xs'}
+  onChange={() => setSize('xs')}
+  name="size"
+  value="xs"
+  label="Extra Small"
+/>
+
+// Small size (20px)
+<Radio
+  size="small"
+  checked={size === 'small'}
+  onChange={() => setSize('small')}
+  name="size"
+  value="small"
+  label="Small"
+/>
+
+// Medium size (24px, default)
+<Radio
+  size="medium"
+  checked={size === 'medium'}
+  onChange={() => setSize('medium')}
+  name="size"
+  value="medium"
+  label="Medium"
+/>
+
+// Large size (28px)
+<Radio
+  size="large"
+  checked={size === 'large'}
+  onChange={() => setSize('large')}
+  name="size"
+  value="large"
+  label="Large"
+/>
+
+// Radio group example
+<div>
+  <Radio
+    checked={paymentMethod === 'card'}
+    onChange={() => setPaymentMethod('card')}
+    name="payment"
+    value="card"
+    label="Credit Card"
+  />
+  <Radio
+    checked={paymentMethod === 'paypal'}
+    onChange={() => setPaymentMethod('paypal')}
+    name="payment"
+    value="paypal"
+    label="PayPal"
+  />
+  <Radio
+    checked={paymentMethod === 'bank'}
+    onChange={() => setPaymentMethod('bank')}
+    name="payment"
+    value="bank"
+    label="Bank Transfer"
+  />
+</div>
+
+// Without label (for tables/lists where context is clear)
+<Radio
+  checked={isSelected}
+  onChange={() => setIsSelected(true)}
+  name="selection"
+  value="item1"
+/>
+
+// Disabled states
+<Radio
+  checked={false}
+  onChange={() => {}}
+  name="disabled-group"
+  value="disabled1"
+  label="Disabled unchecked"
+  disabled
+/>
+
+<Radio
+  checked={true}
+  onChange={() => {}}
+  name="disabled-group"
+  value="disabled2"
+  label="Disabled checked"
+  disabled
+/>
+```
+
+**Параметры:**
+- `checked` - состояние радиокнопки (true/false)
+- `onChange` - функция обработки изменения состояния, получает новое значение (boolean)
+- `name` - имя группы радиокнопок (обязательно для группировки)
+- `value` - значение радиокнопки
+- `size` - размер: "xs", "small", "medium" или "large" (default: "medium")
+- `label` - текст подписи (опционально)
+- `disabled` - отключить радиокнопку
+- `id` - пользовательский ID (по умолчанию генерируется автоматически)
+
+**Стиль:**
+- Размеры привязаны к иконкам: xs (16px), small (20px), medium (24px), large (28px)
+- Выбранное состояние: фон `--color-status-success`, border `--color-status-success` (зеленый), белая точка внутри
+- Невыбранное состояние: фон `--color-item-bg`, border `--color-border`, hover `--color-border-hover`
+- Круглая форма (border-radius: 50%)
+
 ### Card
 
 Карточки бывают двух типов:
@@ -734,11 +869,45 @@ import { AlertCircle } from 'lucide-react';
 <Card padding="small">Small padding</Card>
 <Card padding="medium">Medium padding</Card>
 <Card padding="large">Large padding</Card>
+
+// Card как ссылка (рендерит <a> вместо <div>)
+// При обычном клике: вызывается onClick (preventDefault автоматический)
+// При Cmd/Ctrl+Click или Middle Click: открывается новая вкладка
+<Card
+  padding="medium"
+  variant="interactive"
+  href="/dashboard"
+  onClick={() => navigate('/dashboard')}
+>
+  <H4>Dashboard</H4>
+  <P1>Go to dashboard page</P1>
+</Card>
+
+<Card
+  padding="medium"
+  variant="interactive"
+  href="https://example.com"
+>
+  <H4>External Link</H4>
+  <P1>Visit external site</P1>
+</Card>
+
+// Disabled Card Link
+<Card
+  padding="medium"
+  variant="interactive"
+  href="/disabled"
+  disabled
+>
+  <H4>Disabled</H4>
+  <P1>This card is disabled</P1>
+</Card>
 ```
 
 **Стиль:**
 - **variant="info"** (по умолчанию): прозрачный фон, border `--color-border`
-- **variant="interactive"**: фон `--color-item-bg`, при hover фон `--color-item-bg-hover` и border `--color-border-hover`, курсор pointer
+- **variant="interactive"**: фон `--color-item-bg`, при hover фон `--color-item-bg-hover`, курсор pointer
+- Поддержка `href` для рендера как ссылка с умной обработкой кликов
 
 ### Code
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donkit-ai/design-system",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "description": "Donkit Design System - minimal design tokens and React components",
   "type": "module",
   "main": "src/index.js",

package/src/components/Button.css

@@ -61,6 +61,13 @@
 }
 
 /* Sizes */
+.ds-button--xs {
+  height: var(--height-xs);
+  padding: 0 calc(var(--height-xs) / 2);
+  font-size: var(--font-size-p3);
+  border-radius: var(--radius-xs);
+}
+
 .ds-button--small {
   height: var(--height-s);
   padding: 0 calc(var(--height-s) / 2);

package/src/components/Card.css

@@ -3,6 +3,8 @@
   border-radius: var(--radius-s);
   border: 1px solid var(--color-border);
   transition: border-color var(--transition-normal), background-color var(--transition-normal);
+  text-decoration: none;
+  color: inherit;
 }
 
 .ds-card--interactive {
@@ -11,10 +13,16 @@
   border: none;
 }
 
-.ds-card--interactive:hover {
+.ds-card--interactive:hover:not([aria-disabled="true"]) {
   background-color: var(--color-item-bg-hover);
 }
 
+.ds-card[aria-disabled="true"] {
+  opacity: 0.5;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
 .ds-card--none {
   padding: 0;
 }

package/src/components/Card.jsx

@@ -7,10 +7,12 @@ export function Card({
   variant = 'info',
   hover = false, // deprecated, use variant="interactive"
   onClick,
+  href,
+  disabled = false,
   ...props
 }) {
   const cardVariant = hover ? 'interactive' : variant;
-  const isInteractive = cardVariant === 'interactive' || onClick;
+  const isInteractive = cardVariant === 'interactive' || onClick || href;
 
   const className = [
     'ds-card',
@@ -18,10 +20,41 @@ export function Card({
     isInteractive && 'ds-card--interactive',
   ].filter(Boolean).join(' ');
 
+  // Render as link if href is provided
+  if (href) {
+    const handleClick = (e) => {
+      if (disabled) {
+        e.preventDefault();
+        return;
+      }
+      // При Cmd/Ctrl+Click или Middle Click — пусть браузер откроет новую вкладку
+      if (e.metaKey || e.ctrlKey || e.button === 1) {
+        return;
+      }
+      // Обычный клик — preventDefault и вызов onClick
+      e.preventDefault();
+      onClick?.(e);
+    };
+
+    return (
+      <a
+        className={className}
+        href={disabled ? undefined : href}
+        onClick={handleClick}
+        aria-disabled={disabled ? 'true' : undefined}
+        {...props}
+      >
+        {children}
+      </a>
+    );
+  }
+
+  // Render as button if interactive with onClick
   const Element = isInteractive && onClick ? 'button' : 'div';
   const interactiveProps = isInteractive && onClick ? {
     type: 'button',
     onClick,
+    disabled,
   } : {};
 
   return (

package/src/components/Input.css

@@ -58,6 +58,13 @@
 }
 
 /* Sizes */
+.ds-input--xs {
+  height: var(--height-xs);
+  padding: 0 calc(var(--height-xs) / 4);
+  font-size: var(--font-size-p3);
+  border-radius: var(--radius-xs);
+}
+
 .ds-input--small {
   height: var(--height-s);
   padding: 0 calc(var(--height-s) / 4);
@@ -72,6 +79,10 @@
   border-radius: var(--radius-s);
 }
 
+.ds-input--with-icon.ds-input--xs {
+  padding-left: calc(var(--height-xs) / 4 + 16px + var(--height-xs) / 4);
+}
+
 .ds-input--with-icon.ds-input--small {
   padding-left: calc(var(--height-s) / 4 + 20px + var(--height-s) / 4);
 }
@@ -80,6 +91,10 @@
   padding-left: calc(var(--height-m) / 4 + 24px + var(--height-m) / 4);
 }
 
+.ds-input--with-icon-right.ds-input--xs {
+  padding-right: calc(var(--height-xs) / 4 + 16px + var(--height-xs) / 4);
+}
+
 .ds-input--with-icon-right.ds-input--small {
   padding-right: calc(var(--height-s) / 4 + 20px + var(--height-s) / 4);
 }
@@ -96,6 +111,10 @@
   pointer-events: none;
 }
 
+.ds-input-icon--xs {
+  left: 6px;
+}
+
 .ds-input-icon--small {
   left: 8px;
 }
@@ -121,6 +140,10 @@
   color: var(--color-txt-icon-1);
 }
 
+.ds-input-icon-right--xs {
+  right: 6px;
+}
+
 .ds-input-icon-right--small {
   right: 8px;
 }

package/src/components/Radio.css

@@ -0,0 +1,115 @@
+.ds-radio {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-s);
+  cursor: pointer;
+}
+
+.ds-radio--disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.ds-radio__input {
+  position: absolute;
+  opacity: 0;
+  pointer-events: none;
+}
+
+.ds-radio__circle {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background-color: var(--color-item-bg);
+  border: 1px solid var(--color-border);
+  transition: background-color var(--transition-normal), border-color var(--transition-normal);
+  flex-shrink: 0;
+  border-radius: 50%;
+}
+
+.ds-radio__input:checked + .ds-radio__circle {
+  background-color: var(--color-status-success);
+  border-color: var(--color-status-success);
+}
+
+.ds-radio__input:not(:checked) + .ds-radio__circle:hover {
+  border-color: var(--color-border-hover);
+}
+
+.ds-radio__dot {
+  background-color: var(--color-white);
+  border-radius: 50%;
+  opacity: 0;
+  transition: opacity var(--transition-normal);
+}
+
+.ds-radio__input:checked + .ds-radio__circle .ds-radio__dot {
+  opacity: 1;
+}
+
+.ds-radio__label {
+  font-size: var(--font-size-p1);
+  color: var(--color-txt-icon-1);
+  user-select: none;
+}
+
+/* Extra Small */
+.ds-radio--xs .ds-radio__circle {
+  width: var(--icon-xs);
+  height: var(--icon-xs);
+}
+
+.ds-radio--xs .ds-radio__dot {
+  width: 6px;
+  height: 6px;
+}
+
+.ds-radio--xs .ds-radio__label {
+  font-size: var(--font-size-p3);
+}
+
+/* Small */
+.ds-radio--small .ds-radio__circle {
+  width: var(--icon-s);
+  height: var(--icon-s);
+}
+
+.ds-radio--small .ds-radio__dot {
+  width: 8px;
+  height: 8px;
+}
+
+.ds-radio--small .ds-radio__label {
+  font-size: var(--font-size-p2);
+}
+
+/* Medium */
+.ds-radio--medium .ds-radio__circle {
+  width: var(--icon-m);
+  height: var(--icon-m);
+}
+
+.ds-radio--medium .ds-radio__dot {
+  width: 10px;
+  height: 10px;
+}
+
+.ds-radio--medium .ds-radio__label {
+  font-size: var(--font-size-p1);
+}
+
+/* Large */
+.ds-radio--large .ds-radio__circle {
+  width: var(--icon-l);
+  height: var(--icon-l);
+}
+
+.ds-radio--large .ds-radio__dot {
+  width: 12px;
+  height: 12px;
+}
+
+.ds-radio--large .ds-radio__label {
+  font-size: var(--font-size-p1);
+}

package/src/components/Radio.jsx

@@ -0,0 +1,42 @@
+import React from 'react';
+import './Radio.css';
+
+export function Radio({
+  checked = false,
+  onChange,
+  size = 'medium',
+  disabled = false,
+  label,
+  name,
+  value,
+  id,
+  ...props
+}) {
+  const radioId = id || `radio-${React.useId()}`;
+
+  const className = [
+    'ds-radio',
+    `ds-radio--${size}`,
+    disabled && 'ds-radio--disabled',
+  ].filter(Boolean).join(' ');
+
+  return (
+    <label className={className} htmlFor={radioId}>
+      <input
+        type="radio"
+        id={radioId}
+        className="ds-radio__input"
+        checked={checked}
+        onChange={(e) => onChange?.(e.target.checked)}
+        disabled={disabled}
+        name={name}
+        value={value}
+        {...props}
+      />
+      <span className="ds-radio__circle">
+        <span className="ds-radio__dot" />
+      </span>
+      {label && <span className="ds-radio__label">{label}</span>}
+    </label>
+  );
+}

package/src/components/Select.css

@@ -60,6 +60,13 @@
 }
 
 /* Sizes */
+.ds-select-trigger--xs {
+  height: var(--height-xs);
+  padding: 0 calc(var(--height-xs) / 4);
+  font-size: var(--font-size-p3);
+  border-radius: var(--radius-xs);
+}
+
 .ds-select-trigger--small {
   height: var(--height-s);
   padding: 0 calc(var(--height-s) / 4);

package/src/components/Select.jsx

@@ -53,7 +53,7 @@ export function Select({
   }, [isOpen]);
 
   const selectedOption = options.find(opt => opt.value === value);
-  const iconSize = size === 'small' ? iconSizes.s : iconSizes.m;
+  const iconSize = size === 'xs' ? iconSizes.xs : size === 'small' ? iconSizes.s : iconSizes.m;
 
   return (
     <div className={`ds-select-wrapper ${fullWidth ? 'ds-select-wrapper--full' : ''} ${disabled ? 'ds-select-wrapper--disabled' : ''}`}>

package/src/components/Stepper.css

@@ -98,6 +98,22 @@
 
 /* Sizes */
 
+/* Extra Small */
+.ds-stepper--xs {
+  height: var(--height-xs);
+}
+
+.ds-stepper--xs .ds-stepper-button {
+  width: var(--height-xs);
+  padding: 0;
+}
+
+.ds-stepper--xs .ds-stepper-input {
+  font-size: var(--font-size-p3);
+  letter-spacing: var(--letter-spacing-p3);
+  padding: 0 var(--space-xs);
+}
+
 /* Small */
 .ds-stepper--small {
   height: var(--height-s);

package/src/components/Stepper.jsx

@@ -57,7 +57,7 @@ export function Stepper({
     disabled && 'ds-stepper--disabled',
   ].filter(Boolean).join(' ');
 
-  const iconSize = size === 'small' ? iconSizes.s : iconSizes.m;
+  const iconSize = size === 'xs' ? iconSizes.xs : size === 'small' ? iconSizes.s : iconSizes.m;
 
   return (
     <div className={className}>

package/src/components/Tabs.css

@@ -37,6 +37,13 @@
 }
 
 /* Sizes */
+.ds-tab--xs {
+  height: var(--height-xs);
+  padding: 0 calc(var(--height-xs) / 2);
+  font-size: var(--font-size-p3);
+  border-radius: var(--radius-xs);
+}
+
 .ds-tab--small {
   height: var(--height-s);
   padding: 0 calc(var(--height-s) / 2);

package/src/components/Textarea.css

@@ -87,6 +87,12 @@
 }
 
 /* Sizes */
+.ds-textarea--xs {
+  padding: var(--space-xs);
+  font-size: var(--font-size-p3);
+  border-radius: var(--radius-xs);
+}
+
 .ds-textarea--small {
   padding: var(--space-xs) var(--space-s);
   font-size: var(--font-size-p2);

package/src/index.js

@@ -21,3 +21,4 @@ export { CodeAccordion } from './components/CodeAccordion';
 export { Tooltip } from './components/Tooltip';
 export { Toggle } from './components/Toggle';
 export { Checkbox } from './components/Checkbox';
+export { Radio } from './components/Radio';

package/src/styles/tokens.css

@@ -171,6 +171,7 @@
     /* =====================================
      * 5) Component heights
      * ===================================*/
+    --height-xs: 24px;
     --height-s: 32px;
     --height-m: 44px;
     --height-l: 56px;