@snack-uikit/attachment 0.4.34-preview-7c3c43bf.0 → 0.4.35

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 (3) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +72 -0
  3. package/package.json +9 -9
package/CHANGELOG.md CHANGED
@@ -3,6 +3,25 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## <small>0.4.35 (2026-01-19)</small>
7
+
8
+ * chore(FF-6693): migrate tests from TestCafe to Playwright ([f32aff8](https://github.com/cloud-ru-tech/snack-uikit/commit/f32aff8))
9
+ * chore(FF-6693): tune test configs ([d194f4d](https://github.com/cloud-ru-tech/snack-uikit/commit/d194f4d))
10
+ * docs(FF-7788): readme update ([e3142b8](https://github.com/cloud-ru-tech/snack-uikit/commit/e3142b8))
11
+
12
+
13
+
14
+
15
+
16
+ ## <small>0.4.34 (2025-12-06)</small>
17
+
18
+ ### Only dependencies have been changed
19
+ * [@snack-uikit/card@0.20.12](https://github.com/cloud-ru-tech/snack-uikit/blob/master/packages/card/CHANGELOG.md)
20
+
21
+
22
+
23
+
24
+
6
25
  ## <small>0.4.33 (2025-12-01)</small>
7
26
 
8
27
  ### Only dependencies have been changed
package/README.md CHANGED
@@ -6,6 +6,78 @@
6
6
 
7
7
  [Changelog](./CHANGELOG.md)
8
8
 
9
+ ## Description
10
+
11
+ - Компоненты для отображения файловых вложений в виде карточек: показывают название файла, расширение/тип, состояние (загрузка, ошибка, выбран), а также действия (скачивание, удаление, повтор).
12
+ - Автоматически подставляют заголовок и описание на основе имени файла и его расширения, но позволяют их переопределить.
13
+ - Поддерживают управление состояниями `loading`, `disabled`, `checked`, варианты обрезки длинных строк и единый внешний вид через `Card` из библиотеки.
14
+
15
+ ## Attachment
16
+
17
+ ### Description
18
+
19
+ - Отображает вложение в виде горизонтальной карточки с эмблемой файла/превью, текстовым блоком (заголовок, описание, сообщение об ошибке) и набором действий.
20
+ - Заголовок по умолчанию берётся из имени файла, описание — из его расширения; можно переопределить через пропсы `title` и `description`.
21
+ - Поддерживает состояния загрузки и ошибки, в зависимости от которых показываются действия: скачивание, удаление, повторная попытка.
22
+ - Позволяет управлять выбором карточки (`checked`) и интерактивностью (`disabled`), а также количеством строк для заголовка, описания и ошибки через проп `truncate`.
23
+ - Figma: [Attachment](https://www.figma.com/design/jtGxAPvFJOMir7V0eQFukN/branch/OSnyUq4zigaHiTkL1egWTB/Snack-UI-Kit-3.0.0?m=auto&node-id=6075%3A208643&t=B12jkbmMhhHAG3cv-1)
24
+
25
+ ### Example
26
+
27
+ ```tsx
28
+ import { Attachment } from '@snack-uikit/attachment';
29
+
30
+ function Example() {
31
+ const file = new File([''], 'Document.pdf', { type: 'application/pdf' });
32
+
33
+ return (
34
+ <Attachment
35
+ file={file}
36
+ title="Отчёт за квартал"
37
+ description="PDF, 2.4 MB"
38
+ onDownload={() => console.log('download')}
39
+ onDelete={() => console.log('delete')}
40
+ onRetry={() => console.log('retry')}
41
+ error=""
42
+ size="m"
43
+ checked
44
+ />
45
+ );
46
+ }
47
+ ```
48
+
49
+ ## AttachmentSquare
50
+
51
+ ### Description
52
+
53
+ - Компактная квадратная карточка вложения, которая делает акцент на превью файла (например, изображение) и отображает детали по ховеру.
54
+ - Автоматически берёт заголовок и описание из имени файла и расширения, поддерживает состояния загрузки, ошибки, выбранности и недоступности.
55
+ - Основное содержимое (иконка/превью) и текстовая область с описанием и ошибкой разделены, что удобно для сеток превью (галереи).
56
+ - Figma: [AttachmentSquare](https://www.figma.com/design/jtGxAPvFJOMir7V0eQFukN/branch/OSnyUq4zigaHiTkL1egWTB/Snack-UI-Kit-3.0.0?m=auto&node-id=6075%3A208643&t=B12jkbmMhhHAG3cv-1)
57
+
58
+ ### Example
59
+
60
+ ```tsx
61
+ import { AttachmentSquare } from '@snack-uikit/attachment';
62
+
63
+ function Example() {
64
+ const file = new File([''], 'Picture.jpg', { type: 'image/jpeg' });
65
+
66
+ return (
67
+ <AttachmentSquare
68
+ file={file}
69
+ title="Изображение для отчёта"
70
+ description="JPG, 1.2 MB"
71
+ onDownload={() => console.log('download')}
72
+ onDelete={() => console.log('delete')}
73
+ onRetry={() => console.log('retry')}
74
+ size="s"
75
+ checked
76
+ />
77
+ );
78
+ }
79
+ ```
80
+
9
81
  [//]: DOCUMENTATION_SECTION_START
10
82
  [//]: THIS_SECTION_IS_AUTOGENERATED_PLEASE_DONT_EDIT_IT
11
83
  ## AttachmentSquare
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "access": "public"
5
5
  },
6
6
  "title": "Attachment",
7
- "version": "0.4.34-preview-7c3c43bf.0",
7
+ "version": "0.4.35",
8
8
  "sideEffects": [
9
9
  "*.css",
10
10
  "*.woff",
@@ -36,14 +36,14 @@
36
36
  "license": "Apache-2.0",
37
37
  "scripts": {},
38
38
  "dependencies": {
39
- "@snack-uikit/button": "0.19.16",
40
- "@snack-uikit/card": "0.20.12-preview-7c3c43bf.0",
41
- "@snack-uikit/icon-predefined": "0.7.10",
42
- "@snack-uikit/icons": "0.27.4",
43
- "@snack-uikit/loaders": "0.9.9",
44
- "@snack-uikit/truncate-string": "0.7.6",
45
- "@snack-uikit/utils": "4.0.0",
39
+ "@snack-uikit/button": "0.19.17",
40
+ "@snack-uikit/card": "0.20.13",
41
+ "@snack-uikit/icon-predefined": "0.7.11",
42
+ "@snack-uikit/icons": "0.27.5",
43
+ "@snack-uikit/loaders": "0.9.10",
44
+ "@snack-uikit/truncate-string": "0.7.7",
45
+ "@snack-uikit/utils": "4.0.1",
46
46
  "classnames": "2.5.1"
47
47
  },
48
- "gitHead": "3c5bda8547c57a0f5c965bade1803d307a363301"
48
+ "gitHead": "84371bbf91915f650a852df849cd71d416c5b7b2"
49
49
  }