@salutejs/plasma-new-hope 0.322.0-canary.1941.14637562685.0 → 0.322.0-canary.1944.14660891986.0

package/emotion/cjs/components/Switch/Switch.template-doc.mdx

@@ -7,7 +7,7 @@ import { PropsTable, Description } from '@site/src/components';
 
 # Switch
 <Description name="Switch" />
-<PropsTable name="Switch" />
+<PropsTable name="Switch" include={['defaultChecked']} />
 
 ## Использование
 Компонент `Switch` может содержать лейбл.
@@ -30,7 +30,7 @@ export function App() {
 
 ```tsx live
 import React from 'react';
-import { Button } from '@salutejs/{{ package }}';
+import { Switch } from '@salutejs/{{ package }}';
 
 export function App() {
     return (
@@ -47,7 +47,7 @@ export function App() {
 
 ```tsx live
 import React from 'react';
-import { Button } from '@salutejs/{{ package }}';
+import { Switch } from '@salutejs/{{ package }}';
 
 export function App() {
     return (

package/emotion/cjs/components/Table/Table.template-doc.mdx

@@ -492,7 +492,7 @@ export type TableColumnData = {
             ];
 
             return (
-                <div style={{ display: "block" }}>
+                <div style=\{{ display: "block" }}>
                     <ButtonGroup size="xs" isCommonButtonStyles={false}>
                         <Button text="Очистить выбранные" view="warning" size="xs" onClick={clearSelected} />
                         <Button text="Убрать сортировку" view="warning" size="xs" onClick={clearSorted} />
@@ -504,7 +504,7 @@ export type TableColumnData = {
                     <br />
                     <br />
 
-                    <div style={{ overflow: "scroll" }}>
+                    <div style=\{{ overflow: "scroll" }}>
                         <Table
                             data={data}
                             columns={columns}

package/emotion/cjs/components/Tabs/Tabs.template-doc.mdx

@@ -5,6 +5,10 @@ title: Tabs
 
 import { PropsTable, Description } from '@site/src/components';
 
+# Tabs
+Набор компонентов для создания вкладок.
+Структура для вкладок похожа на структуру маркированных списков.
+
 ## Tabs
 
 <Description name="Tabs" />
@@ -16,7 +20,7 @@ import { PropsTable, Description } from '@site/src/components';
 <PropsTable name="TabItem" />
 
 :::caution Взаимоисключающие свойства
-Свойство `value` - это значение таба. Оно отображается справа от основного текста.<br/>
+Свойство `value` - это значение Tab. Оно отображается справа от основного текста.<br/>
 `value` и `contentRight` взаимоисключающие: если передано одно, второе передать нельзя.
 :::
 
@@ -61,8 +65,8 @@ export function App() {
 }
 ```
 
-### Расположение табов
-Табы могут быть горизонтальными (по умолчанию) и вертикальными. За это отвечает свойство `orientation`.
+### Расположение Tabs
+Компонент может быть горизонтальными (по умолчанию) и вертикальными. За это отвечает свойство `orientation`.
 
 ```tsx live
 import React, { useState } from 'react';
@@ -97,11 +101,11 @@ export function App() {
 ```
 
 ### Пример с прокруткой
-При выборе таба происходит прокрутка до выбранного таба.
+При выборе Tab происходит прокрутка до выбранного TabItem.
 
 ```tsx live
 import React, { useState } from 'react';
-import { Tabs, TabItem, Button } from '@salutejs/plasma-web';
+import { Tabs, TabItem, Button } from '@salutejs/{{ package }}';
 import { IconClock } from '@salutejs/plasma-icons';
 
 export function App() {
@@ -189,8 +193,8 @@ export function App() {
 
 ### Подключение клавиатурной навигации
 Для этого необходимо дополнительно прокинуть свойства `index, itemIndex, onIndexChange`.<br/>
-Для горизонтальных табов: клавиши ArrowLeft, ArrowRight, Home, End для навигации по вкладкам.<br/>
-Для вертикальных табов: клавиши ArrowUp, ArrowDown, Home, End для навигации по вкладкам.
+Для горизонтальных Tabs: клавиши ArrowLeft, ArrowRight, Home, End для навигации по вкладкам.<br/>
+Для вертикальных Tabs: клавиши ArrowUp, ArrowDown, Home, End для навигации по вкладкам.
 
 ```tsx live
 import React, { useState } from 'react';

package/emotion/cjs/components/TextArea/TextArea.template-doc.mdx

@@ -161,11 +161,18 @@ export function App() {
 
 
 ### Обязательность поля
-Обязательность поля задаётся с помощью свойств `required` и `requiredPlacement`. Где `requiredPlacement` отвечает за выравнивание и принимает значения `"left"` и `"right"`:
+
+:::tip
+Наличие индикатора регулируется свойством `hasRequiredIndicator`.
+:::
+
+Обязательность поля задаётся с помощью свойств `required` и `requiredPlacement`.
+
+Где `requiredPlacement` отвечает за выравнивание и принимает значения `"left"` и `"right"`:
 
 ```tsx live
 import React from 'react';
-import { TextField } from '@salutejs/{{ package }}';
+import { TextArea } from '@salutejs/{{ package }}';
 
 export function App() {
     return (

package/emotion/cjs/components/TextField/TextField.template-doc.mdx

@@ -37,7 +37,7 @@ export function App() {
 ```
 
 ### Размер поля
-Размер поля задаётся с помощью свойства `size`. Свойство принимает значения `"l"` и `"m"`:
+Размер поля задаётся с помощью свойства `size`. Свойство принимает значения `"l" | "m" | "s" | "xs"`:
 
 ```tsx live
 import React from 'react';
@@ -53,8 +53,8 @@ export function App() {
             />
             <TextField
                 placeholder="Размер"
-                size="m"
-                defaultValue="M48"
+                size="s"
+                defaultValue="S40"
             />
         </div>
     );
@@ -62,9 +62,9 @@ export function App() {
 ```
 
 ### Статус поля
-Статус поля задается с помощью свойства `status`.
-Возможные значения свойства: `success`, `warning` и `error`.
-На отображение TextField так же влияют свойства `clear` и `hasDivider`:
+Статус поля задается с помощью свойства `view`.
+
+Возможные значения свойства: `"positive" | "warning" | "negative"`
 
 ```tsx live
 import React from 'react';
@@ -75,46 +75,61 @@ export function App() {
         <div style=\{{ display: "flex", flexDirection: "column", gap: "1rem" }}>
             <div style=\{{ display: "flex", gap: "0.5rem" }}>
                 <TextField
-                    placeholder="Статус"
-                    status="success"
+                    placeholder="Статус positive"
+                    view="positive"
                     size="m"
-                    defaultValue="Успех"
+                    defaultValue="Positive"
                 />
                 <TextField
-                    placeholder="Статус"
-                    status="warning"
+                    placeholder="Статус warning"
+                    view="warning"
                     size="m"
-                    defaultValue="Предупреждение"
+                    defaultValue="Warning"
                 />
                 <TextField
-                    placeholder="Статус"
-                    status="error"
+                    placeholder="Статус Ошибка"
+                    view="negative"
                     size="m"
-                    defaultValue="Ошибка"
+                    defaultValue="Negative"
                 />
             </div>
+        </div>
+    );
+}
+```
+
+### Вариация Clear
+На отображение компонента так же влияют свойства `clear` и `hasDivider`:
+
+```tsx live
+import React from 'react';
+import { TextField } from '@salutejs/{{ package }}';
+
+export function App() {
+    return (
+        <div style=\{{ display: "flex", flexDirection: "column", gap: "1rem" }}>
             <div style=\{{ display: "flex", gap: "0.5rem" }}>
                 <TextField
-                    placeholder="Статус"
-                    status="success"
+                    placeholder="Статус positive"
+                    view="positive"
                     size="m"
-                    defaultValue="Успех"
+                    defaultValue="Positive"
                     clear
                     hasDivider
                 />
                 <TextField
-                    placeholder="Статус"
-                    status="warning"
+                    placeholder="Статус warning"
+                    view="warning"
                     size="m"
-                    defaultValue="Предупреждение"
+                    defaultValue="Warning"
                     clear
                     hasDivider
                 />
                 <TextField
-                    placeholder="Статус"
-                    status="error"
+                    placeholder="Статус negative"
+                    view="negative"
                     size="m"
-                    defaultValue="Ошибка"
+                    defaultValue="Negative"
                     clear
                     hasDivider
                 />
@@ -125,8 +140,11 @@ export function App() {
 ```
 
 ### Подсказка
-Для вывода подсказки снизу от поля используйте свойство `helperText`,
-для подсказки в виде Tooltip - `hintText`, для подсказки сверху справа - `titleCaption`:
+Для вывода подсказок:
+
+- `leftHelper` внизу слева под компонентом
+- `titleCaption` сверху справа над компонентом
+- `hintText` для подсказки в виде `Tooltip`
 
 ```tsx live
 import React from 'react';
@@ -138,7 +156,7 @@ export function App() {
             <TextField
                 placeholder="Введите значение"
                 defaultValue="Значение"
-                helperText="Подсказка снизу"
+                leftHelper="Подсказка снизу"
                 titleCaption="Подсказка сверху"
                 hintText="Подсказка в виде Tooltip"
                 hintView="default"
@@ -151,7 +169,9 @@ export function App() {
 
 ### Режим ввода
 С помощью свойства `enumerationType` можно вводить элементы как теги. Свойство `chipType` изменяет внешний вид чипа.
-С помощью `chipView` можно задать общий вид Chip. Валидация Chip происходит с помощью функции chipValidator.
+
+С помощью `chipView` можно задать общий вид `Chip`. Валидация `Chip` происходит с помощью функции `chipValidator`.
+
 По нажатию Enter, после ввода нужного текста, он преобразуется в Chip.
 
 ```tsx live
@@ -168,7 +188,7 @@ export function App() {
                 defaultValue="Значение"
                 size="l"
                 enumerationType="chip"
-                helperText="Подсказка снизу"
+                leftHelper="Подсказка снизу"
                 chips={["Значение 1", "Значение 2"]}
                 chipView="positive"
                 chipValidator={validateChip}
@@ -179,7 +199,7 @@ export function App() {
                 defaultValue="Значение"
                 size="l"
                 enumerationType="chip"
-                helperText="Подсказка снизу"
+                leftHelper="Подсказка снизу"
                 chips={["Значение 1"]}
                 chipType="text"
             />
@@ -188,9 +208,15 @@ export function App() {
 }
 ```
 
-
 ### Обязательность поля
-Обязательность поля задаётся с помощью свойств `required` и `requiredPlacement`. Где `requiredPlacement` отвечает за выравнивание и принимает значения `"left"` и `"right"`:
+
+:::tip
+Наличие индикатора регулируется свойством `hasRequiredIndicator`.
+:::
+
+Обязательность поля задаётся с помощью свойств `required` и `requiredPlacement`.
+
+Где `requiredPlacement` отвечает за выравнивание и принимает значения `"left"` и `"right"`:
 
 ```tsx live
 import React from 'react';
@@ -209,7 +235,66 @@ export function App() {
                 required
                 requiredPlacement="right"
             />
+            <TextField
+                placeholder="Введите значение"
+                label="Поле обязательное, но не имеет визуального индикатора"
+                required
+                requiredPlacement="right"
+                hasRequiredIndicator={false}
+            />
         </div>
     );
 }
 ```
+
+## Примеры
+
+### TextField + очистка поля
+
+```tsx live
+import React, { useState } from "react";
+import { TextField } from "@salutejs/{{ package }}";
+import { IconClose } from "@salutejs/plasma-icons";
+
+export function App() {
+  const [value, setValue] = useState("");
+
+  const ControlClear = (props: { onClick: () => void }) => {
+      return (
+        <div {...props}>
+          <IconClose size="xs" color="inherit" />
+        </div>
+      );
+  };
+
+  return (
+    <div>
+      <TextField
+        placeholder="Положение иконки"
+        value={value}
+        onChange={(e) => {
+          setValue(e.target.value);
+        }}
+        contentRight={
+          <ControlClear
+            onClick={() => {
+              setValue("");
+            }}
+          />
+        }
+      />
+    </div>
+  );
+}
+```
+
+## Клавиатурная навигация
+
+Данный компонент может полностью управляться с помощью клавиатуры, используя следующие клавиши:
+-  по нажатию `Tab` фокусируемся на input
+-  если enumeratinType=`chip` после ввода текста, по нажатию `Enter`, input очистится и появится Chip
+-  если введен текст в input по нажатию `ArrowLeft` или `ArrowRight` каретка передвигается по тексту
+-  при достижении левой границы текста или отсутствии текста в input, при нажатии `Backspace` удаляем последний Chip, если он есть
+-  при достижении левой границы текста или отсутствии текста в input, при нажатии `ArrowLeft` переключаемся на последний Chip, если он есть
+-  при фокусе на Chip работает переключение фокуса на другие Chip по нажатию `ArrowLeft`, `ArrowRight`; если же Chip крайний правый, при нажатии `ArrowRight` фокус переходит на input
+

package/emotion/cjs/components/Toast/Toast.template-doc.mdx

@@ -9,6 +9,11 @@ import { PropsTable, Description } from '@site/src/components';
 <Description name="Toast" />
 <PropsTable name="Toast" />
 
+:::caution Устаревшие значения свойства `view`
+Значения `dark` и `light` являются устаревшими.<br/>
+Для изменения фона `Toast` используйте компонент `ViewContainer` (см. <a href="#пример-использования">пример использования</a>)
+:::
+
 ## Система подсказок
 Существует готовая система текстовых подсказок, для использования которой необходимо обернуть приложение в `ToastProvider`:
 
@@ -120,7 +125,6 @@ export interface ShowToastArgs {
 ```
 
 ## Пример использования
-
 Для изменения цветовой темы компонента `Toast` используйте свойство `view` компонента `ViewContainer`.
 
 ```jsx live
@@ -130,7 +134,7 @@ import { useToast, ToastProvider, Button, ViewContainer } from '@salutejs/{{ pac
 export function App() {
 
     const ToastExample = () => {
-        const { showToast, hideToast } = useToast()
+        const { showToast } = useToast()
 
         const onShow = () => {}
         const onHide = () => {}
@@ -168,3 +172,45 @@ export function App() {
     )
 }
 ```
+
+## Вид иконки
+Значения `positive` и `negative` свойства `view` изменяют цвет иконки.<br/>
+Чтобы цвет применился, установите в иконке свойство `color` со значением `inherit`:
+
+```jsx live
+import React from 'react'
+import { IconBell } from '@salutejs/plasma-icons';
+import { useToast, ToastProvider, Button } from '@salutejs/{{ package }}'
+
+export function App() {
+    const Icon = () => <IconBell color="inherit" size="xs" />;
+
+    const ToastExample = () => {
+        const { showToast } = useToast()
+
+        const onShow = () => {}
+        const onHide = () => {}
+        const toastData = {
+            contentLeft: <Icon />,
+            text: 'Подсказка c иконкой',
+            position: 'bottom',
+            role: 'status',
+            hasClose: true,
+            fade: false,
+            size: 'm',
+            view: 'positive',
+            timeout: 3000,
+            onShow,
+            onHide
+        }
+
+        return <Button onClick={() => showToast(toastData)} text="Вызвать подсказку" />
+    }
+
+    return (
+        <ToastProvider>
+            <ToastExample />
+        </ToastProvider>
+    )
+}
+```

package/emotion/cjs/components/Tooltip/Tooltip.template-doc.mdx

@@ -17,13 +17,28 @@ import { PropsTable, Description } from '@site/src/components';
 
 ```tsx live
 import React from 'react';
-import { Tooltip } from '@salutejs/{{ package }}';
-import { IconApps } from '@salutejs/plasma-icons';
+import { Tooltip, Button } from '@salutejs/{{ package }}';
 
 export function App() {
     return (
-        <div style=\{{marginLeft: '100px',marginBottom: '35px'}}>
-            <Tooltip target={( <IconApps />)} text="Высокое качество воспроизведения" placement="bottom" hasArrow opened />
+        <div style=\{{display: 'grid', gridTemplateColumns: 'repeat(3, max-content)', gridGap: '1rem 3.5rem', padding: '3.5rem'}}>
+            <Tooltip
+                target={<Tooltip target={<Button>Btn</Button>} placement="left" opened text="left" />}
+                placement="top-start"
+                opened
+                text="top-start"
+                view="default"
+            />
+            <Tooltip target={<Button>Btn</Button>} placement="top" opened text="top" />
+            <Tooltip
+                target={<Tooltip target={<Button>Btn</Button>} placement="right" opened text="right" />}
+                placement="top-end"
+                opened
+                text="top-end"
+            />
+            <Tooltip target={<Button>Btn</Button>} placement="bottom-start" opened text="bottom-start" />
+            <Tooltip target={<Button>Btn</Button>} placement="bottom" opened text="bottom" />
+            <Tooltip target={<Button>Btn</Button>} placement="bottom-end" opened text="bottom-end" />
         </div>
     );
 }

package/emotion/cjs/components/Tree/Tree.template-doc.mdx

@@ -218,4 +218,3 @@ type TreeItem = {
         ```
     </TabItem>
 </Tabs>
-