sinde-ui 0.0.0-stage → 1.0.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.
Files changed (92) hide show
  1. package/LICENSE.md +171 -0
  2. package/NOTICE +21 -0
  3. package/README.md +296 -2
  4. package/THIRD_PARTY_LICENSES.md +131 -0
  5. package/dist/chunks/use-ui-config-Ckaon2pR.mjs +10 -0
  6. package/dist/components/SAppShell.vue.d.ts +21 -0
  7. package/dist/components/SAsideNav.vue.d.ts +27 -0
  8. package/dist/components/SAvatar.vue.d.ts +21 -0
  9. package/dist/components/SBtn.vue.d.ts +15 -0
  10. package/dist/components/SCheckbox.vue.d.ts +24 -0
  11. package/dist/components/SCopy.vue.d.ts +26 -0
  12. package/dist/components/SCropper.vue.d.ts +16 -0
  13. package/dist/components/SDataTable.vue.d.ts +57 -0
  14. package/dist/components/SDateTimePicker/Calendar.vue.d.ts +40 -0
  15. package/dist/components/SDateTimePicker/Popover.vue.d.ts +22 -0
  16. package/dist/components/SDateTimePicker/QuickActions.vue.d.ts +13 -0
  17. package/dist/components/SDateTimePicker/Time.vue.d.ts +29 -0
  18. package/dist/components/SDateTimePicker/TimeWheel.vue.d.ts +15 -0
  19. package/dist/components/SDateTimePicker/index.vue.d.ts +33 -0
  20. package/dist/components/SDatetime.vue.d.ts +20 -0
  21. package/dist/components/SDocMarkdown.vue.d.ts +6 -0
  22. package/dist/components/SField.vue.d.ts +14 -0
  23. package/dist/components/SFile.vue.d.ts +27 -0
  24. package/dist/components/SGradation.vue.d.ts +24 -0
  25. package/dist/components/SIcon.vue.d.ts +8 -0
  26. package/dist/components/SImage.vue.d.ts +60 -0
  27. package/dist/components/SInput.vue.d.ts +21 -0
  28. package/dist/components/SLink.vue.d.ts +16 -0
  29. package/dist/components/SList.vue.d.ts +19 -0
  30. package/dist/components/SLoad.vue.d.ts +7 -0
  31. package/dist/components/SNav.vue.d.ts +13 -0
  32. package/dist/components/SNotification.vue.d.ts +15 -0
  33. package/dist/components/SNotificationHost.vue.d.ts +3 -0
  34. package/dist/components/SRange.vue.d.ts +19 -0
  35. package/dist/components/SScrollableEdges.vue.d.ts +21 -0
  36. package/dist/components/SSelect.vue.d.ts +39 -0
  37. package/dist/components/SSpoiler.vue.d.ts +24 -0
  38. package/dist/components/STextSpans.vue.d.ts +35 -0
  39. package/dist/components/STextarea.vue.d.ts +16 -0
  40. package/dist/components/SToggle.vue.d.ts +26 -0
  41. package/dist/components/STooltip.vue.d.ts +16 -0
  42. package/dist/components/STree.vue.d.ts +11 -0
  43. package/dist/components/icons/book-open.vue.d.ts +3 -0
  44. package/dist/components/icons/braces.vue.d.ts +3 -0
  45. package/dist/components/icons/calendar.vue.d.ts +3 -0
  46. package/dist/components/icons/camera.vue.d.ts +3 -0
  47. package/dist/components/icons/check.vue.d.ts +3 -0
  48. package/dist/components/icons/chevron.vue.d.ts +3 -0
  49. package/dist/components/icons/clock.vue.d.ts +3 -0
  50. package/dist/components/icons/close.vue.d.ts +3 -0
  51. package/dist/components/icons/collapse.vue.d.ts +3 -0
  52. package/dist/components/icons/contact-round.vue.d.ts +3 -0
  53. package/dist/components/icons/crown.vue.d.ts +3 -0
  54. package/dist/components/icons/expand.vue.d.ts +3 -0
  55. package/dist/components/icons/file-pen-line.vue.d.ts +3 -0
  56. package/dist/components/icons/fit-screen.vue.d.ts +3 -0
  57. package/dist/components/icons/flip-x.vue.d.ts +3 -0
  58. package/dist/components/icons/flip-y.vue.d.ts +3 -0
  59. package/dist/components/icons/home.vue.d.ts +3 -0
  60. package/dist/components/icons/inbox.vue.d.ts +3 -0
  61. package/dist/components/icons/layout.vue.d.ts +3 -0
  62. package/dist/components/icons/package.vue.d.ts +3 -0
  63. package/dist/components/icons/receipt.vue.d.ts +3 -0
  64. package/dist/components/icons/refresh.vue.d.ts +3 -0
  65. package/dist/components/icons/rotate-left.vue.d.ts +3 -0
  66. package/dist/components/icons/rotate-right.vue.d.ts +3 -0
  67. package/dist/components/icons/send.vue.d.ts +3 -0
  68. package/dist/components/icons/shield-alert.vue.d.ts +3 -0
  69. package/dist/components/icons/trash-2.vue.d.ts +3 -0
  70. package/dist/components/icons/users.vue.d.ts +3 -0
  71. package/dist/components/icons/vertical-dots.vue.d.ts +3 -0
  72. package/dist/components/icons/zoom-in.vue.d.ts +3 -0
  73. package/dist/components/icons/zoom-out.vue.d.ts +3 -0
  74. package/dist/composables/use-clipboard.d.ts +10 -0
  75. package/dist/composables/use-link-component.d.ts +5 -0
  76. package/dist/composables/use-notifications.d.ts +24 -0
  77. package/dist/composables/use-open-select.d.ts +2 -0
  78. package/dist/composables/use-optional-router.d.ts +16 -0
  79. package/dist/composables/use-sinde-user.d.ts +16 -0
  80. package/dist/composables/use-ui-config.d.ts +19 -0
  81. package/dist/icons.d.ts +5 -0
  82. package/dist/index.d.ts +44 -0
  83. package/dist/index.mjs +3892 -0
  84. package/dist/nuxt.d.ts +18 -0
  85. package/dist/nuxt.mjs +44 -0
  86. package/dist/runtime/plugin.mjs +8 -0
  87. package/dist/style.css +2 -0
  88. package/dist/utils/count-form.d.ts +2 -0
  89. package/dist/utils/date.d.ts +5 -0
  90. package/dist/utils/media.d.ts +9 -0
  91. package/dist/utils/picker-dt.d.ts +30 -0
  92. package/package.json +100 -4
package/LICENSE.md ADDED
@@ -0,0 +1,171 @@
1
+ # Лицензия на программный продукт «Fullstack Boilerplate» (SINDE)
2
+
3
+ Версия лицензии: 1.0. Действует для копий продукта, полученных начиная с
4
+ 18 ноября 2026 года.
5
+
6
+ > **Статус документа: условия полные, поля владельца заполнены.**
7
+ > Условия ниже применяются целиком и в неизменном виде. Правообладатель и
8
+ > основание возникновения права указаны в п. 1.1.1.
9
+
10
+ ## 1. Стороны и предмет
11
+
12
+ 1.1. **Лицензиар** — ИП Воротников Дмитрий Владимирович, ИНН 910307682390,
13
+ ОГРНИП 323911200072041; email: bank@sinde.ru (далее — Лицензиар).
14
+ Почтовый адрес для корреспонденции предоставляется по запросу Лицензиата.
15
+ Реквизиты также опубликованы на странице «Условия продажи» сайта (`/legal`).
16
+
17
+ 1.1.1. **Правообладание.** Исключительные права на Продукт принадлежат
18
+ Лицензиару — ИП Воротников Дмитрий Владимирович (ИНН 910307682390,
19
+ ОГРНИП 323911200072041) — как автору и правообладателю, создавшему Продукт
20
+ собственными силами. Основание возникновения права — создание произведения
21
+ собственными силами (авторство). Настоящая лицензия применяется к продажам
22
+ на условиях, изложенных в настоящем документе.
23
+
24
+ 1.2. **Лицензиат** — лицо, оплатившее заказ и получившее доступ к архиву
25
+ Продукта в личном кабинете.
26
+
27
+ 1.3. **Продукт** — программное обеспечение в исходном коде: бэкенд, фронтенд,
28
+ конфигурация инфраструктуры, миграции, скрипты сборки и развёртывания,
29
+ документация, а также сопроводительные файлы из архива (`NOTICE`,
30
+ `THIRD_PARTY_LICENSES.md`).
31
+
32
+ 1.4. Лицензиар предоставляет Лицензиату **неисключительное право
33
+ использования** Продукта на условиях настоящей лицензии. Исключительное право
34
+ на Продукт, включая право на его переработку и распространение, **не
35
+ передаётся Лицензиату** и остаётся у правообладателя, указанного в п. 1.1.1.
36
+ Настоящая лицензия не является договором об отчуждении исключительного права и
37
+ не передаёт Лицензиату исключительных прав.
38
+
39
+ 1.5. Лицензия вступает в силу с момента оплаты заказа и действует бессрочно
40
+ в отношении полученной версии Продукта. Прекращение доступа к сайту
41
+ Лицензиара, удаление аккаунта или прекращение работы сервиса не прекращают
42
+ право использования уже полученной версии Продукта.
43
+
44
+ ## 2. Что разрешено
45
+
46
+ Лицензиату разрешается:
47
+
48
+ 2.1. **Изучать** исходный код Продукта, документацию и конфигурацию.
49
+
50
+ 2.2. **Запускать** Продукт, в том числе разворачивать любое количество
51
+ экземпляров на собственной инфраструктуре или инфраструктуре, арендованной
52
+ Лицензиатом.
53
+
54
+ 2.3. **Изменять** исходный код, удалять ненужные модули, добавлять собственные
55
+ функции, интегрировать Продукт со своими и сторонними сервисами.
56
+
57
+ 2.4. **Использовать** Продукт и его производные версии в личных, внутренних
58
+ корпоративных и коммерческих целях, включая предоставление доступа к
59
+ собственным сервисам, созданным на основе Продукта, третьим лицам, в том числе
60
+ на возмездной основе.
61
+
62
+ 2.5. **Использовать** фрагменты кода Продукта в собственных разработках без
63
+ ограничения по объёму.
64
+
65
+ 2.6. **Распространять** производные версии в составе собственного продукта,
66
+ если такой продукт не является самостоятельным шаблоном, boilerplate, стартовым
67
+ набором, генератором кода или иным товаром, конкурирующим с Продуктом
68
+ (см. п. 3.2).
69
+
70
+ 2.7. Права по пп. 2.1–2.6 предоставляются **одной организации** — Лицензиату,
71
+ включая его штатных сотрудников и подрядчиков, работающих в интересах
72
+ Лицензиата. Передача прав третьим лицам оформляется отдельным письменным
73
+ соглашением с Лицензиаром (п. 3.5).
74
+
75
+ ## 3. Что запрещено
76
+
77
+ Лицензиату запрещается:
78
+
79
+ 3.1. **Перепродавать, распространять, публиковать или иным образом передавать
80
+ исходный код Продукта** (в исходном или изменённом виде) как самостоятельный
81
+ товар, в том числе бесплатно, а также размещать его в открытом доступе.
82
+
83
+ 3.2. Создавать на основе Продукта **конкурирующий товар** — boilerplate,
84
+ стартовый набор, шаблон, генератор приложений или курс, предметом которого
85
+ является сам исходный код Продукта или его существенная часть.
86
+
87
+ 3.3. **Сублицензировать** права, предоставленные настоящей лицензией, без
88
+ письменного согласия Лицензиара.
89
+
90
+ 3.4. Удалять или изменять уведомления об авторских правах, файлы `NOTICE`,
91
+ `LICENSE.md` и `THIRD_PARTY_LICENSES.md`, а также уведомления третьих лиц в
92
+ составе Продукта.
93
+
94
+ 3.5. Передавать права по настоящей лицензии другой организации (включая
95
+ передачу при реорганизации, продаже бизнеса или переходе проекта к другому
96
+ лицу) без письменного согласия Лицензиара. Согласие не требуется при
97
+ внутренней передаче между подразделениями одного юридического лица.
98
+
99
+ 3.6. Использовать наименование, товарные знаки и логотипы Лицензиара для
100
+ продвижения собственных продуктов, кроме указания на то, что продукт основан
101
+ на «Fullstack Boilerplate», в описательной форме.
102
+
103
+ 3.7. Предъявлять Продукт как собственную разработку при перепродаже
104
+ производных версий — происхождение базового кода должно быть указано.
105
+
106
+ ## 4. Сторонние компоненты
107
+
108
+ 4.1. Продукт содержит компоненты третьих лиц, распространяемые на условиях
109
+ собственных лицензий (перечень — `THIRD_PARTY_LICENSES.md`). Эти лицензии
110
+ сохраняют силу и распространяются на соответствующие компоненты.
111
+
112
+ 4.2. Ничто в настоящей лицензии не ограничивает права Лицензиата, которые
113
+ предоставлены ему лицензиями третьих лиц, и не расширяет их.
114
+
115
+ 4.3. Лицензиар не является правообладателем сторонних компонентов и не
116
+ предоставляет на них дополнительных прав.
117
+
118
+ ## 5. Обновления и поддержка
119
+
120
+ 5.1. Настоящая лицензия распространяется на версию Продукта, полученную по
121
+ оплаченному заказу. Доступ к архиву и возможность получить новую временную
122
+ ссылку сохраняются бессрочно.
123
+
124
+ 5.2. Предоставление новых версий, обновлений и технической поддержки не
125
+ является предметом настоящей лицензии и регулируется условиями, опубликованными
126
+ на сайте Лицензиара, если такие условия заявлены.
127
+
128
+ ## 6. Гарантии и ответственность
129
+
130
+ 6.1. Продукт предоставляется «как есть» (as is). Лицензиар не гарантирует, что
131
+ Продукт не содержит ошибок и подходит для конкретной цели Лицензиата.
132
+
133
+ 6.2. Лицензиар не несёт ответственности за упущенную выгоду и косвенные
134
+ убытки Лицензиата, возникшие в связи с использованием Продукта.
135
+
136
+ 6.3. Совокупная ответственность Лицензиара ограничена суммой, фактически
137
+ уплаченной Лицензиатом за Продукт.
138
+
139
+ 6.4. Ограничения пп. 6.1–6.3 не применяются в случаях, когда ограничение
140
+ ответственности запрещено применимым правом, в том числе в отношении прав
141
+ потребителя.
142
+
143
+ ## 7. Возврат средств
144
+
145
+ 7.1. Порядок возврата определяется «Условиями продажи», опубликованными на
146
+ сайте Лицензиара (`/legal`).
147
+
148
+ 7.2. При возврате средств настоящая лицензия прекращается: Лицензиат обязан
149
+ прекратить использование Продукта и удалить полученные копии и производные
150
+ версии.
151
+
152
+ ## 8. Применимое право
153
+
154
+ 8.1. К настоящей лицензии применяется право Российской Федерации.
155
+
156
+ 8.2. Споры разрешаются путём переговоров, а при недостижении согласия — в суде
157
+ по месту нахождения Лицензиара, если иное не предусмотрено императивными
158
+ нормами права.
159
+
160
+ ---
161
+
162
+ ## English summary (not a substitute for the Russian text)
163
+
164
+ Non-exclusive, perpetual, non-transferable license for one legal entity to use,
165
+ modify, self-host and commercially exploit the purchased source code. Reselling,
166
+ redistributing or open-sourcing the source code itself, sublicensing, and building
167
+ a competing boilerplate/template product from it are prohibited. The purchased
168
+ copy is licensed, not assigned: exclusive rights remain with the copyright holder
169
+ named in clause 1.1.1 (ИП Воротников Дмитрий Владимирович).
170
+ Third-party components keep their own licenses (see `THIRD_PARTY_LICENSES.md`).
171
+ The Russian text above prevails.
package/NOTICE ADDED
@@ -0,0 +1,21 @@
1
+ Fullstack Boilerplate (SINDE)
2
+
3
+ Copyright (c) 2026 ИП Воротников Дмитрий Владимирович. All rights reserved.
4
+
5
+ Правообладатель — ИП Воротников Дмитрий Владимирович (ИНН 910307682390,
6
+ ОГРНИП 323911200072041); сведения совпадают с LICENSE.md (п. 1.1.1).
7
+
8
+ Продукт предоставляется по лицензии, а не путём отчуждения прав. Условия
9
+ использования — LICENSE.md. Исключительные права, включая право на
10
+ распространение исходного кода, остаются у правообладателя.
11
+
12
+ Сторонние компоненты, входящие в Продукт, распространяются на условиях
13
+ собственных лицензий. Полный реестр с обязательствами — в
14
+ THIRD_PARTY_LICENSES.md. Исходные пакеты и тексты их лицензий устанавливаются
15
+ менеджерами зависимостей, указанными в source/be/go.mod и
16
+ source/fe/package.json.
17
+
18
+ Товарные знаки и названия третьих лиц (Go, Fiber, Nuxt, Vue, PostgreSQL,
19
+ Redis, Docker, Caddy, SeaweedFS, Postfix, T-Bank) принадлежат их
20
+ правообладателям и используются только для идентификации. Упоминание не
21
+ означает партнёрства или одобрения.
package/README.md CHANGED
@@ -1,3 +1,297 @@
1
- # Temporary Holding Version
1
+ # sinde-ui
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Переиспользуемая UI-система SINDE: компоненты Vue 3 для Nuxt 4 с префиксом `S`, Tailwind CSS 4 и собственный Nuxt-модуль. Пакет извлечён из frontend-приложения Seed и сохраняет имена, props, emits, slots, поведение и визуальное оформление исходных компонентов.
4
+
5
+ ## Содержание
6
+
7
+ - [Требования](#требования)
8
+ - [Установка](#установка)
9
+ - [Подключение Nuxt-модуля](#подключение-nuxt-модуля)
10
+ - [Tailwind CSS](#tailwind-css)
11
+ - [Импорт стилей](#импорт-стилей)
12
+ - [Использование](#использование)
13
+ - [Публичные экспорты](#публичные-экспорты)
14
+ - [Конфигурация](#конфигурация)
15
+ - [Разработка](#разработка)
16
+ - [Сборка и проверки](#сборка-и-проверки)
17
+ - [Публикация](#публикация)
18
+ - [Лицензия](#лицензия)
19
+
20
+ ## Требования
21
+
22
+ | Инструмент | Версия |
23
+ | ------------ | ------------------------------- |
24
+ | Bun | `>= 1.4.4` |
25
+ | Node.js | `>= 22` |
26
+ | Nuxt | `^4.0.0` (проверено на `4.6.4`) |
27
+ | Vue | `^3.5.0 \|\| ^3.6.0-0` |
28
+ | Tailwind CSS | `^4.3.5` |
29
+
30
+ Nuxt — необязательная peer-зависимость: компоненты работают и при прямом импорте в приложении Vue 3, но Nuxt-модуль и авто-регистрация требуют Nuxt 4. Без маршрутизатора навигационные компоненты (`SNav`, `SAsideNav`, `SImage` с `route-sync`) просто не подсвечивают активный пункт и не меняют адрес.
31
+
32
+ ## Установка
33
+
34
+ ```bash
35
+ bun add sinde-ui
36
+ # или
37
+ npm install sinde-ui
38
+ ```
39
+
40
+ Пакет опубликован в публичный registry npmjs.org, дополнительная настройка registry не нужна.
41
+
42
+ Альтернатива — установка прямо из Git-репозитория:
43
+
44
+ ```bash
45
+ bun add git+https://git.sinde.ru/seed-sinde/sinde-ui.git
46
+ ```
47
+
48
+ SSH доступен опционально: адрес с портом (`ssh://git@git.sinde.ru:2222/...`) показан кнопкой «Clone» в интерфейсе репозитория. Собранный `dist/` хранится в Git, поэтому установка из репозитория не требует запуска сборки.
49
+
50
+ ## Подключение Nuxt-модуля
51
+
52
+ ```ts
53
+ // nuxt.config.ts
54
+ export default defineNuxtConfig({
55
+ modules: ["sinde-ui/nuxt"],
56
+ // Vue 3.6: компоненты Seed используют vapor-совместимые SFC
57
+ vue: {vapor: true},
58
+ css: ["~/assets/css/main.css"],
59
+ vite: {
60
+ plugins: [tailwindcss()]
61
+ },
62
+ sindeUi: {
63
+ // Все опции необязательны
64
+ css: true, // добавлять sinde-ui/style.css автоматически
65
+ global: true, // регистрировать компоненты глобально
66
+ prefix: "", // имена S* сохраняются
67
+ timeZone: "Europe/Moscow", // зона отображения SDatetime
68
+ locale: "ru-RU", // локаль календаря и форматирования
69
+ mediaBasePath: "/api/media/files" // прокси медиафайлов для mediaFileSrc
70
+ }
71
+ })
72
+ ```
73
+
74
+ Модуль:
75
+
76
+ - регистрирует все публичные компоненты с исходными именами (`SBtn`, `SSelect`, `SDateTimePicker`, …) через `addComponent`, без повторной регистрации;
77
+ - делает composables доступными через auto-import Nuxt;
78
+ - добавляет `style.css` пакета в CSS приложения (можно отключить `css: false`);
79
+ - добавляет runtime-плагин, передающий `public.sindeUi` в UI-систему;
80
+ - не зависит от каталогов исходного приложения Seed.
81
+
82
+ ## Tailwind CSS
83
+
84
+ Компоненты используют классы Tailwind CSS 4. Tailwind не сканирует `node_modules` автоматически, поэтому пакет нужно явно указать источником классов в том CSS-файле, где подключён Tailwind:
85
+
86
+ ```css
87
+ /* app/assets/css/main.css */
88
+ @import "tailwindcss";
89
+ @import "sinde-ui/style.css";
90
+
91
+ /* Путь указывается относительно этого CSS-файла. */
92
+ @source "../../../node_modules/sinde-ui/dist";
93
+ ```
94
+
95
+ `@source` должен указывать на `dist` установленного пакета: там находятся собранные компоненты со всеми строками классов, включая варианты состояний (`hover:`, `focus-visible:`, `disabled:`, адаптивные `sm:`/`lg:`).
96
+
97
+ Проверить, что классы попали в собранный CSS приложения:
98
+
99
+ ```bash
100
+ bunx @tailwindcss/cli -i app/assets/css/main.css -o /tmp/app.css
101
+ grep -c -- '--text-default' /tmp/app.css # > 0
102
+ ```
103
+
104
+ ## Импорт стилей
105
+
106
+ Публичный stylesheet содержит только то, что нужно компонентам: дизайн-токены (`--accent`, `--default`, `--border`, …), утилиты `.ui-image-grid`, `.hide-scrollbar`, `.ui-focus-peer`, базовую линию полей ввода и стили Cropper.js. Глобальная тема приложения Seed (`html`, `body`, `::selection`, кастомные скроллбары) в пакет не переносится.
107
+
108
+ ```ts
109
+ import "sinde-ui/style.css"
110
+ ```
111
+
112
+ При подключённом Nuxt-модуле импорт добавляется автоматически.
113
+
114
+ ## Использование
115
+
116
+ Через auto-import после подключения модуля:
117
+
118
+ ```vue
119
+ <template>
120
+ <SField label="Почта">
121
+ <SInput v-model="email" placeholder="you@example.com" />
122
+ </SField>
123
+ <SBtn label="Сохранить" :state="saving ? 'load' : 'idle'" @click="save" />
124
+ </template>
125
+ ```
126
+
127
+ Прямой импорт:
128
+
129
+ ```ts
130
+ import {SBtn, SSelect, useNotifications, type SSelectOption} from "sinde-ui"
131
+ ```
132
+
133
+ ```vue
134
+ <script setup lang="ts">
135
+ import {SBtn, SSelect} from "sinde-ui"
136
+
137
+ const options: SSelectOption[] = [
138
+ {value: "ru", label: "Русский"},
139
+ {value: "en", label: "English"}
140
+ ]
141
+ const language = ref<string | null>("ru")
142
+ </script>
143
+
144
+ <template>
145
+ <SSelect v-model="language" :options="options" clearable />
146
+ <SBtn label="Применить" state="active" />
147
+ </template>
148
+ ```
149
+
150
+ ### SDateTimePicker
151
+
152
+ ```vue
153
+ <script setup lang="ts">
154
+ const value = ref("2024-12-25T14:30:00")
155
+ const timezone = ref("Europe/Moscow")
156
+ </script>
157
+
158
+ <template>
159
+ <SDateTimePicker
160
+ v-model="value"
161
+ v-model:timezone="timezone"
162
+ show-timezone
163
+ show-seconds
164
+ min="2024-01-01T00:00:00"
165
+ max="2025-12-31T23:59:59"
166
+ />
167
+ </template>
168
+ ```
169
+
170
+ Поддерживаются дата, время, секунды, часовой пояс, ограничения `min`/`max`, быстрые действия («Сегодня», «Сейчас», «Начало дня», …), клавиатурная навигация по календарю и колёсам времени.
171
+
172
+ ### Уведомления
173
+
174
+ ```vue
175
+ <!-- app.vue -->
176
+ <template>
177
+ <NuxtLayout>
178
+ <NuxtPage />
179
+ </NuxtLayout>
180
+ <SNotificationHost />
181
+ </template>
182
+ ```
183
+
184
+ ```ts
185
+ const {success, error} = useNotifications()
186
+ success("Готово", "Документ сохранён")
187
+ error("Ошибка", "Не удалось сохранить")
188
+ ```
189
+
190
+ ## Публичные экспорты
191
+
192
+ | Группа | Экспорты |
193
+ | --- | --- |
194
+ | Компоненты | `SAppShell`, `SAsideNav`, `SAvatar`, `SBtn`, `SCheckbox`, `SCopy`, `SCropper`, `SDataTable`, `SDatetime`, `SDateTimePicker`, `SDocMarkdown`, `SField`, `SFile`, `SGradation`, `SIcon`, `SImage`, `SInput`, `SLink`, `SList`, `SLoad`, `SNav`, `SNotification`, `SNotificationHost`, `SRange`, `SScrollableEdges`, `SSelect`, `SSpoiler`, `STextSpans`, `STextarea`, `SToggle`, `STooltip`, `STree` |
195
+ | Константы | `BtnState`, `SDatetimeView`, `TextGap`, `TextSize`, `TextColor` |
196
+ | Типы | `SBtnState`, `SDataTableColumn`, `SDataTableRow`, `SDatetimeValue`, `SDatetimeView`, `SGradationOption`, `SImageItem`, `SNavItem`, `SAsideNavItem`, `SSelectOption`, `STextGap`, `STextSize`, `STextColor`, `SIconName`, `SindeUiConfig`, `SindeUserInfo`, `AppNotification`, `NotificationType`, `DateTimePickerParts`, `DateTimePickerVisibility`, `DateTimePickerLocaleInfo`, `WordForms` |
197
+ | Composables | `useClipboard`, `useNotifications`, `useSindeUiConfig`, `setSindeUiConfig`, `useSindeUser`, `provideSindeUser`, `useOptionalRouter`, `useOptionalRoutePath`, `useOpenSelect`, `useLinkComponent` |
198
+ | Утилиты | `countForm`, `getFormatter`, `mediaFileSrc`, `normalizeMediaKey`, `parseDateTimePickerModel`, `serializeDateTimePickerModel`, `formatDateTimePickerDisplay`, `dateToPickerParts`, `compareDateOnly`, `clampDateTimePickerParts`, `resolveDateTimePickerLocale`, `localTimeZone`, `allTimeZoneOptions` |
199
+ | Иконки | `SIcon`, `icons`, `iconNames` |
200
+ | Nuxt | `sinde-ui/nuxt` (default export модуля, `componentNames`, `ModuleOptions`) |
201
+ | Стили | `sinde-ui/style.css` |
202
+
203
+ Внутренние компоненты `SDateTimePicker` (`Popover`, `Calendar`, `Time`, `TimeWheel`, `QuickActions`) публичным API не являются: они импортируются внутри пакета и не требуют ручной регистрации.
204
+
205
+ ## Конфигурация
206
+
207
+ Компонентам не нужен стор приложения. Данные, которые в Seed брались из `useAuth` и `useRuntimeConfig`, передаются через props или адаптер:
208
+
209
+ ```ts
210
+ // app.vue — данные пользователя для SAvatar
211
+ provideSindeUser(() => ({
212
+ name: user.value?.display_name,
213
+ src: mediaFileSrc(avatar.value?.icon_image_key),
214
+ to: "/profile"
215
+ }))
216
+ ```
217
+
218
+ ```vue
219
+ <!-- или напрямую -->
220
+ <SAvatar src="/avatar.webp" name="Дмитрий" to="/profile" />
221
+ ```
222
+
223
+ `SAppShell` не зависит от навигации и почтового потока Seed: навигация передаётся слотом `nav`, а события `ready`/`dispose` позволяют приложению запустить свои фоновые процессы.
224
+
225
+ ## Разработка
226
+
227
+ ```bash
228
+ bun install
229
+ bun run build # Vite (ESM + style.css) → Golar tsc (.d.ts)
230
+ bun run typecheck # Golar typecheck (TypeScript 7 + Vue)
231
+ bun run lint # oxlint
232
+ bun run format # Prettier: форматирование исходников
233
+ bun run check # typecheck + lint + format:check
234
+ bun run fix # typecheck + lint:fix + format
235
+ ```
236
+
237
+ Инструменты разделены:
238
+
239
+ | Этап | Инструмент |
240
+ | --- | --- |
241
+ | Редактор (подсветка, IntelliSense, навигация) | TypeScript 6 (`devDependencies`), `.vscode/settings.json` фиксирует `node_modules/typescript/lib` и отключает `useTsgo` |
242
+ | Проверка типов и генерация деклараций | Golar (`golar typecheck`, `golar tsc -p tsconfig.build.json`) с плагином `@golar/vue` |
243
+ | Линтинг | oxlint (`.oxlintrc.json`: правила по умолчанию, `dist/` и `auto-imports.d.ts` исключены) |
244
+ | Форматирование | Prettier (`.prettierrc`, `.editorconfig`), плагин `prettier-plugin-tailwindcss` сортирует классы по стандартному порядку утилит |
245
+ | Сборка публикуемых модулей | Vite в режиме library build (`@vitejs/plugin-vue`) |
246
+
247
+ Все этапы сборки и проверки типов используют один `tsconfig.json`: Golar проверяет `.ts` и `.vue` по той же конфигурации, по которой Vite собирает пакет.
248
+
249
+ ### Структура
250
+
251
+ ```
252
+ src/
253
+ components/ # S*.vue, icons/, SDateTimePicker/
254
+ composables/ # useNotifications, useClipboard, конфигурация, адаптеры
255
+ utils/ # даты, picker-dt, медиа, словоформы
256
+ icons.ts # реестр иконок
257
+ index.ts # публичный API
258
+ nuxt.ts # Nuxt-модуль (sinde-ui/nuxt)
259
+ runtime/plugin.ts # runtimeConfig.public.sindeUi → UI-система
260
+ style.css # публичный stylesheet
261
+ style-entry.ts # техническая точка входа сборки CSS
262
+ ```
263
+
264
+ ## Сборка и проверки
265
+
266
+ ```bash
267
+ bun run build # dist/index.mjs, dist/nuxt.mjs, dist/style.css, dist/**/*.d.ts
268
+ bun run typecheck # Golar: 0 ошибок
269
+ bun run lint # oxlint: 0 предупреждений и ошибок
270
+ bun run format:check # Prettier: все файлы соответствуют стилю
271
+ bun run check # typecheck + lint + format:check
272
+ bun run pack:check # состав npm-архива
273
+ ```
274
+
275
+ `dist/`, `auto-imports.d.ts`, а также юридические документы (`LICENSE.md`, `NOTICE`, `THIRD_PARTY_LICENSES.md`) исключены из проверки форматирования: первые два генерируются, последние не переформатируются.
276
+
277
+ `dist/` хранится в Git: это позволяет устанавливать пакет напрямую из репозитория и гарантирует, что Tailwind-сканер видит собранные классы.
278
+
279
+ ## Публикация
280
+
281
+ ```bash
282
+ bun run build
283
+ npm publish # registry из publishConfig → npmjs.org, доступ public
284
+ ```
285
+
286
+ Перед публикацией можно проверить состав архива и занятость версии:
287
+
288
+ ```bash
289
+ bun run pack:check # npm pack --dry-run
290
+ npm view sinde-ui version
291
+ ```
292
+
293
+ Версия не перезаписывается: для нового релиза поднимите `version` в `package.json`.
294
+
295
+ ## Лицензия
296
+
297
+ Пакет распространяется на условиях исходного продукта SINDE — см. [LICENSE.md](./LICENSE.md) и [NOTICE](./NOTICE). Правообладатель — ИП Воротников Дмитрий Владимирович.
@@ -0,0 +1,131 @@
1
+ # Сторонние компоненты: лицензии и обязательства
2
+
3
+ Реестр составлен по фактическому содержимому зависимостей проекта:
4
+ `source/be/go.mod` + `go.sum` (Go) и `source/fe/bun.lock` + установленное
5
+ дерево `node_modules` (JavaScript). Проверка выполнена 18 ноября 2026 года.
6
+
7
+ - Go-модулей в графе: **63** (15 прямых, остальные транзитивные).
8
+ - npm-пакетов в установленном дереве: **574**.
9
+ - Собственных шрифтов и растровых изображений в поставке нет; иконки —
10
+ встроенные SVG-контуры в `source/fe/app/components/SIcon.vue`, библиотечных
11
+ иконочных наборов не подключено.
12
+
13
+ ## 1. Прямые зависимости бэкенда (Go)
14
+
15
+ | Компонент | Версия | Лицензия | Обязательства | Риск |
16
+ | --- | --- | --- | --- | --- |
17
+ | github.com/gofiber/fiber/v3 | v3.4.0 | MIT | сохранить текст лицензии и copyright | нет |
18
+ | github.com/jackc/pgx/v5 | v5.9.2 | MIT | то же | нет |
19
+ | github.com/redis/go-redis/v9 | v9.18.0 | BSD-2-Clause | сохранить copyright и условия | нет |
20
+ | github.com/minio/minio-go/v7 | v7.0.97 | Apache-2.0 | сохранить LICENSE и NOTICE, указать изменения | нет |
21
+ | github.com/golang-jwt/jwt/v5 | v5.3.1 | MIT | сохранить текст лицензии | нет |
22
+ | github.com/google/uuid | v1.6.0 | BSD-3-Clause | сохранить copyright, не использовать имена авторов для продвижения | нет |
23
+ | github.com/joho/godotenv | v1.5.1 | MIT | сохранить текст лицензии | нет |
24
+ | github.com/pquerna/otp | v1.5.0 | Apache-2.0 | сохранить LICENSE и NOTICE | нет |
25
+ | github.com/boombuler/barcode | v1.0.1 | MIT | сохранить текст лицензии | нет |
26
+ | github.com/goccy/go-json | v0.10.5 | MIT | сохранить текст лицензии | нет |
27
+ | github.com/gen2brain/webp | v0.5.5 | MIT | сохранить текст лицензии | нет |
28
+ | github.com/gen2brain/avif | v0.4.4 | MIT | сохранить текст лицензии; внутри — WASM-сборки libavif/dav1d/aom, см. п. 4 | низкий: нужна проверка патентной оговорки AV1 |
29
+ | gopkg.in/yaml.v3 | v3.0.1 | Apache-2.0 + MIT | сохранить оба текста и copyright | нет |
30
+ | golang.org/x/crypto | v0.55.0 | BSD-3-Clause | сохранить copyright | нет |
31
+ | golang.org/x/text | v0.41.0 | BSD-3-Clause | сохранить copyright | нет |
32
+
33
+ Транзитивные модули (`github.com/valyala/fasthttp`, `github.com/klauspost/compress`,
34
+ `github.com/tetratelabs/wazero`, `github.com/minio/*`, `github.com/jackc/*`,
35
+ `github.com/gofiber/utils/v2`, `github.com/gofiber/schema` и другие) распространяются
36
+ под MIT, BSD-2/3-Clause или Apache-2.0. `github.com/klauspost/compress` — смешанный
37
+ набор Apache-2.0 / BSD-3-Clause / MIT. Копилефт-лицензий (GPL, AGPL, LGPL, SSPL)
38
+ в графе нет.
39
+
40
+ ## 2. Прямые зависимости фронтенда (npm)
41
+
42
+ | Компонент | Версия | Лицензия | Обязательства | Риск |
43
+ | --- | --- | --- | --- | --- |
44
+ | nuxt | ^4.6.4 | MIT | сохранить copyright | нет |
45
+ | vue | ^3.6.0-rc.15 | MIT | то же | нет: RC-версия, см. примечание в отчёте |
46
+ | @floating-ui/vue | ^2.0.1 | MIT | то же | нет |
47
+ | @speed-highlight/core | ^2.1.0 | MIT | то же | нет |
48
+ | cropperjs | 1.6.2 | MIT | то же | нет |
49
+ | marked | ^18.2.1 | MIT | то же | нет |
50
+ | tailwindcss / @tailwindcss/vite | ^4.3.5 | MIT | то же | нет |
51
+ | golar, @golar/vue | ^0.1.11 | MIT | dev-зависимость, в поставку рантайма не входит | нет |
52
+ | knip | ^6.45.1 | ISC | dev-зависимость | нет |
53
+ | oxlint | ^1.93.0 | MIT | dev-зависимость | нет |
54
+ | prettier / prettier-plugin-tailwindcss | ^3.10.1 / ^0.8.1 | MIT | dev-зависимость | нет |
55
+ | typescript | ~6.0.3 | Apache-2.0 | dev-зависимость, сохранить NOTICE | нет |
56
+ | vue-router | ^5.5.1 | MIT | dev-зависимость (нужна для typecheck, см. `source/fe/README.md`) | нет |
57
+
58
+ ## 3. Транзитивные npm-пакеты: распределение по лицензиям
59
+
60
+ | Лицензия | Пакетов | Комментарий |
61
+ | --- | --- | --- |
62
+ | MIT | 485 | обязательство — сохранить copyright и текст лицензии |
63
+ | ISC | 31 | то же |
64
+ | Apache-2.0 | 17 | сохранить LICENSE/NOTICE |
65
+ | BlueOak-1.0.0 | 12 | разрешительная, обязательств по раскрытию нет |
66
+ | BSD-3-Clause | 9 | сохранить copyright |
67
+ | BSD-2-Clause | 6 | то же |
68
+ | MPL-2.0 | 2 | `lightningcss`, `lightningcss-linux-x64-gnu` — файловый копилефт: изменения в самих файлах MPL нужно раскрывать; сборка проекта изменения не вносит |
69
+ | CC0-1.0 | 2 | без обязательств |
70
+ | CC-BY-4.0 | 1 | `caniuse-lite` (данные) — требуется указание источника при распространении данных |
71
+ | 0BSD | 1 | без обязательств |
72
+ | MIT OR Apache-2.0 | 1 | `@cloudflare/kv-asset-handler` |
73
+ | MIT OR CC0-1.0 | 1 | `type-fest` |
74
+ | (BSD-3-Clause OR GPL-2.0) | 1 | `node-forge` — выбрана BSD-3-Clause, GPL-2.0 не применяется |
75
+ | не указана в package.json | 5 | служебные фикстуры тестов (`baz`, `browser_field`, `false_main`, `invalid_main`, `nw-pre-gyp-module-test`) — не являются библиотеками и в рантайм не попадают |
76
+
77
+ Копилефт-лицензий, требующих раскрытия исходников производного продукта
78
+ (GPL/AGPL), в рантайм-зависимостях нет. Единственный GPL-вариант —
79
+ двойная лицензия `node-forge`, для которой выбрана BSD-3-Clause.
80
+
81
+ ## 4. Встроенные бинарные артефакты
82
+
83
+ `github.com/gen2brain/avif` собирает libavif, dav1d и aom в WASM и исполняет их
84
+ через `wazero`. Компоненты распространяются под BSD-2-Clause (dav1d, libavif) и
85
+ AOMedia Patent License 1.0 (aom/AV1). Обязательства: сохранять уведомления о
86
+ copyright и не инициировать патентные споры по AV1. Для коммерческого
87
+ распространения продукта это стандартная и допустимая конфигурация, но
88
+ патентная оговорка AV1 должна быть учтена в договорной документации.
89
+
90
+ ## 5. Что нужно сделать распространителю
91
+
92
+ 1. Не удалять `LICENSE.md`, `NOTICE`, `THIRD_PARTY_LICENSES.md` из архива и из
93
+ производных версий (п. 3.4 лицензии продукта).
94
+ 2. При распространении собранного бинарника или контейнера приложить тексты
95
+ MIT/BSD/Apache-лицензий зависимостей — они лежат в `node_modules` и в
96
+ Go-модулях и попадают в образ вместе с кодом.
97
+ 3. При изменении файлов под MPL-2.0 (`lightningcss`) раскрывать изменённые
98
+ файлы; при распространении данных `caniuse-lite` сохранять указание
99
+ источника CC-BY-4.0.
100
+ 4. Перед публикацией новой версии повторять сверку: состав лицензий меняется
101
+ вместе с обновлением зависимостей.
102
+
103
+ ## 6. Как воспроизвести проверку
104
+
105
+ ```sh
106
+ # Go: граф модулей
107
+ cd source/be && go list -m all
108
+
109
+ # npm: лицензии установленного дерева
110
+ cd source/fe && python3 - <<'PY'
111
+ import json, os, collections
112
+ rows = {}
113
+ for root, _, files in os.walk("node_modules"):
114
+ if "package.json" in files:
115
+ try:
116
+ d = json.load(open(os.path.join(root, "package.json")))
117
+ except Exception:
118
+ continue
119
+ if d.get("name"):
120
+ lic = d.get("license") or d.get("licenses")
121
+ rows[(d["name"], d.get("version"))] = str(lic)
122
+ print(len(rows), "packages")
123
+ for lic, n in collections.Counter(rows.values()).most_common():
124
+ print(n, lic)
125
+ PY
126
+ ```
127
+
128
+ Проверка лицензий Go-модулей выполнялась по метаданным модулей
129
+ (pkg.go.dev / репозитории): сомнительные случаи — `pquerna/otp` (Apache-2.0),
130
+ `gen2brain/avif` (MIT), `klauspost/compress` (Apache-2.0/BSD-3-Clause/MIT),
131
+ `gopkg.in/yaml.v3` (Apache-2.0 + MIT).
@@ -0,0 +1,10 @@
1
+ import { reactive as e, readonly as t } from "vue";
2
+ // src/composables/use-ui-config.ts
3
+ var n = e({
4
+ timeZone: void 0,
5
+ mediaBasePath: "/api/media/files",
6
+ locale: "ru-RU"
7
+ }), r = (e) => {
8
+ for (let [t, r] of Object.entries(e)) r != null && r !== "" && (n[t] = r);
9
+ }, i = () => t(n);
10
+ export { i as n, r as t };