@omnisass/library 0.2.0 → 0.2.1

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@omnisass/library",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
5
5
  "main": "index.scss",
6
6
  "scripts": {
package/package.scss CHANGED
@@ -53,7 +53,7 @@ $description: "Набор утилит, миксинов, расширений
53
53
  /// @name version
54
54
  /// @access private
55
55
  /// @type String | Number
56
- $version: "0.2.0";
56
+ $version: "0.2.1";
57
57
 
58
58
  /// Тип лицензии библиотеки - используется для указания
59
59
  /// условий использования и распространения.
package/test.md DELETED
@@ -1,168 +0,0 @@
1
- Напиши мне комментарии SassDoc для этой функции:
2
-
3
- ```scss
4
- @function convert-camel2kebab($value) {
5
-
6
- $-result: '';
7
- $-length: string.length($value);
8
-
9
- @for $i from 1 through $-length {
10
-
11
- $-char: string.slice($value, $i, $i);
12
-
13
- @if $-char == string.to-upper-case($-char) and $i > 1 {
14
- $-result: $-result + '-' + string.to-lower-case($-char);
15
- } @else {
16
- $-result: $-result + string.to-lower-case($-char);
17
- }
18
-
19
- }
20
-
21
- @return $-result;
22
-
23
- }
24
- ```
25
- но, так, как это сделано на примере этой функции:
26
-
27
- ```scss
28
- /// Конвертирует значения из относительных единиц (`em`) в
29
- /// пиксели (`px`).
30
- ///
31
- /// Функция выполняет преобразование значений в единицах `em`
32
- /// в пиксели относительно заданного базового размера. Это
33
- /// особенно полезно для обратных расчетов, когда необходимо
34
- /// получить точное пиксельное значение из относительного,
35
- /// учитывая контекст родительского элемента.
36
- ///
37
- /// Важные особенности функции:
38
- /// - Преобразует `em` в `px` с указанием единиц `px`
39
- /// - Поддерживает кастомный базовый размер (по умолчанию 16px)
40
- /// - Удаляет единицы измерения для корректного математического
41
- /// расчета
42
- /// - Возвращает результат с единицами `px` для семантической
43
- /// ясности
44
- /// - Обрабатывает целые и дробные значения
45
- /// - Полезен для расчета точных размеров из относительных
46
- /// величин
47
- /// - Обеспечивает обратное преобразование к `convert-px2em`
48
- /// - Учитывает относительную природу `em` единиц
49
- /// ---
50
- /// @name convert-em2px
51
- /// @group utilities-converters
52
- /// @since 2025.12.27
53
- /// @access public
54
- /// @author Murad Rustamov (therteenten)
55
- /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
56
- /// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
57
- /// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
58
- /// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Единицы измерения в числах
59
- /// @link https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Values_and_units См. также: MDN Web Docs - Значения и единицы измерения CSS
60
- /// @link https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Sizing_items_in_CSS См. также: MDN Web Docs - Размеры элементов в CSS
61
- /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/length См. также: MDN Web Docs - CSS-тип <length>
62
- /// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
63
- /// @link https://css-tricks.com/snippets/css/guide-to-em-and-rem-units-in-css/ См. также: CSS-Tricks - Руководство по em и rem единицам в CSS
64
- /// @link https://sass-guidelin.es/ru/#section-41 См. также: Sass Guidelines - Раздел про математические операции
65
- /// @link https://www.w3schools.com/css/css_units.asp См. также: W3Schools - CSS единицы измерения
66
- /// @example scss - Стандартное преобразование (базовый размер 16px)
67
- /// @debug convert-em2px(1em); // 16px
68
- /// @debug convert-em2px(0.5em); // 8px
69
- /// @debug convert-em2px(1.5em); // 24px
70
- /// @debug convert-em2px(2em); // 32px
71
- /// @debug convert-em2px(3em); // 48px
72
- /// @debug convert-em2px(0.25em); // 4px
73
- /// @debug convert-em2px(0.0625em); // 1px
74
- /// @example scss - Дробные значения em
75
- /// @debug convert-em2px(0.78125em); // 12.5px
76
- /// @debug convert-em2px(1.171875em); // 18.75px
77
- /// @debug convert-em2px(0.03125em); // 0.5px
78
- /// @debug convert-em2px(0.9em); // 14.4px
79
- /// @debug convert-em2px(1.125em); // 18px
80
- /// @debug convert-em2px(1.333em); // 21.328px
81
- /// @example scss - Кастомный базовый размер
82
- /// @debug convert-em2px(1em, 10px); // 10px (база 10px)
83
- /// @debug convert-em2px(2em, 10px); // 20px (база 10px)
84
- /// @debug convert-em2px(0.8em, 10px); // 8px (база 10px)
85
- /// @debug convert-em2px(0.8em, 20px); // 16px (база 20px)
86
- /// @debug convert-em2px(1.2em, 20px); // 24px (база 20px)
87
- /// @debug convert-em2px(0.5em, 20px); // 10px (база 20px)
88
- /// @example scss - Граничные случаи
89
- /// @debug convert-em2px(0em); // 0px
90
- /// @debug convert-em2px(0em, 16px); // 0px
91
- /// @debug convert-em2px(10em); // 160px
92
- /// @debug convert-em2px(62.5em); // 1000px
93
- /// @debug convert-em2px(0.01em, 100px); // 1px
94
- /// @debug convert-em2px(100em); // 1600px
95
- /// @example scss - Отрицательные значения
96
- /// @debug convert-em2px(-1em); // -16px
97
- /// @debug convert-em2px(-0.5em); // -8px
98
- /// @debug convert-em2px(-1.5em); // -24px
99
- /// @debug convert-em2px(-2em, 8px); // -16px
100
- /// @example scss - Безразмерные числа как аргументы
101
- /// @debug convert-em2px(1, 16); // 16px (без единиц, но работает)
102
- /// @debug convert-em2px(0.5, 16); // 8px
103
- /// @debug convert-em2px(1.5, 16); // 24px
104
- /// @example scss - Контекст вложенности em
105
- /// // em зависят оass-lang.com/documentation/values/numbers#unitsт контекста родительского элемента
106
- /// .parent { font-size: 20px; }
107
- /// .child {
108
- /// // 1em внутри .parent равно 20px
109
- /// $px-value: convert-em2px(1em, 20px); // 20px
110
- /// // 0.5em внутри .parent равно 10px
111
- /// $px-value: convert-em2px(0.5em, 20px); // 10px
112
- /// }
113
- ///
114
- /// // Вложенные em множатся
115
- /// .grandparent { font-size: 16px; }
116
- /// .parent { font-size: 1.5em; } // 24px
117
- /// .child {
118
- /// // 1em внутри .parent равно 24px, а не 16px!
119
- /// $px-value: convert-em2px(1em, 24px); // 24px
120
- /// }
121
- /// @example css - Результат
122
- /// .parent {
123
- /// font-size: 20px;
124
- /// }
125
- ///
126
- /// .grandparent {
127
- /// font-size: 16px;
128
- /// }
129
- ///
130
- /// .parent {
131
- /// font-size: 1.5em;
132
- /// }
133
- /// @param {Number} $em - Значение в единицах `em` для
134
- /// конвертации. Может быть целым или дробным числом,
135
- /// положительным или отрицательным. Единицы измерения (`em`)
136
- /// удаляются для расчета, но ожидается, что значение
137
- /// изначально выражено в `em`.
138
- /// @param {Number} $base [16px] - Базовый размер в пикселях
139
- /// для расчета. По умолчанию используется `16px`, что
140
- /// соответствует стандартному размеру шрифта в большинстве
141
- /// браузеров. Может быть любым положительным числом (обычно
142
- /// в пикселях). Важно, что параметр представляет размер
143
- /// шрифта родительского элемента, относительно которого
144
- /// рассчитываются `em`.
145
- /// @return {Number} - Значение в единицах `px`, рассчитанное
146
- /// по формуле: `($em * $base) * 1px`. Возвращает дробное
147
- /// или целое число с единицами измерения `px`.
148
- /// @throws {Error} - Может выбросить ошибку при передаче
149
- /// нечисловых значений. Для корректной работы оба
150
- /// аргумента должны быть числами.
151
- @function convert-em2px($em, $base: 16px) {
152
- @return helpers.number-strip-unit($em) * helpers.number-strip-unit($base) * 1px;
153
- }
154
- ```
155
-
156
- но, учти несколько моментов:
157
-
158
- 1. Старайся описания укладывать такую же ширину строки
159
- 2. В строке `/// @since` нужно указать текущую дату в формате `YYYY.MM.DD`
160
- 3. Строку `/// @author Murad Rustamov (therteenten)` менять не нужно, как и строку `/// @group`
161
- 4. Первые две ссылки также необходимо не трогать:
162
- ```scss
163
- /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
164
- /// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
165
- ```
166
- 5. Ссылки должны быть по теме, к которой относится смысл функции и ссылки должны быть в виде `/// @link https://some.com См. также: Название сайта - Название старницы` (данное правило не относится к первым двум ссылкам из пункта 4)
167
- 6. Количество ссылок не меньше 8
168
- 7. Примеры `/// @example` должны быть достоверны и без ошибок
package/test.scss DELETED
@@ -1,405 +0,0 @@
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
- // ============================================================================
11
- // 7. ФУНКЦИИ ЭКРАНИРОВАНИЯ И КОДИРОВАНИЯ
12
- // ============================================================================
13
-
14
- // Простое URL-кодирование
15
-
16
-
17
- // Экранирование кавычек
18
- @function escape-quotes($string) {
19
- $string: string-replace($string, '"', '\"');
20
- $string: string-replace($string, "'", "\'");
21
- @return $string;
22
- }
23
-
24
- // Экранирование для использования в CSS-контенте
25
- @function escape-css-content($string) {
26
- $string: string-replace($string, "\\", "\\\\");
27
- $string: string-replace($string, '"', '\"');
28
- $string: string-replace($string, "'", "\'");
29
- $string: string-replace($string, "\n", "\\A ");
30
- @return $string;
31
- }
32
-
33
- // ============================================================================
34
- // 8. ФУНКЦИИ ДЛЯ РАБОТЫ С ПУТЯМИ И ФАЙЛАМИ
35
- // ============================================================================
36
-
37
- // Получение имени файла из пути
38
- @function get-filename($path) {
39
- $last-slash: string-index($path, "/");
40
- @if $last-slash {
41
- @return string.slice($path, $last-slash + 1);
42
- }
43
-
44
- $last-backslash: string-index($path, "\\");
45
- @if $last-backslash {
46
- @return string.slice($path, $last-backslash + 1);
47
- }
48
-
49
- @return $path;
50
- }
51
-
52
- // Получение расширения файла
53
- @function get-extension($filename) {
54
- $last-dot: string-index($filename, ".");
55
- @if $last-dot {
56
- @return string.slice($filename, $last-dot + 1);
57
- }
58
- @return "";
59
- }
60
-
61
- // Получение имени файла без расширения
62
- @function get-filename-without-extension($filename) {
63
- $extension: get-extension($filename);
64
- @if string-length($extension) > 0 {
65
- $extension-length: string-length($extension) + 1; // +1 для точки
66
- @return string.slice($filename, 1, -$extension-length - 1);
67
- }
68
- @return $filename;
69
- }
70
-
71
- // Получение директории из пути
72
- @function get-directory($path) {
73
- $last-slash: string-index($path, "/");
74
- @if $last-slash {
75
- @return string.slice($path, 1, $last-slash);
76
- }
77
-
78
- $last-backslash: string-index($path, "\\");
79
- @if $last-backslash {
80
- @return string.slice($path, 1, $last-backslash);
81
- }
82
-
83
- @return "./";
84
- }
85
-
86
- // ============================================================================
87
- // 9. ФУНКЦИИ ГЕНЕРАЦИИ И УНИКАЛЬНЫХ ИДЕНТИФИКАТОРОВ
88
- // ============================================================================
89
-
90
- // Генерация уникального идентификатора с префиксом
91
- @function unique-string-id($prefix: "id-") {
92
- $random: random(1000000);
93
- $timestamp: unique-id(); // Встроенная функция Sass
94
- @return $prefix + $random + "-" + $timestamp;
95
- }
96
-
97
- // Генерация хеша из строки (упрощенный вариант)
98
- @function string-hash($string) {
99
- $hash: 0;
100
- $length: string-length($string);
101
-
102
- @for $i from 1 through $length {
103
- $char: string.slice($string, $i, $i);
104
- $hash: (($hash * 31) + string-index("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", $char)) % 1000000;
105
- }
106
-
107
- @return $hash;
108
- }
109
-
110
- // ============================================================================
111
- // 10. ФУНКЦИИ ДЛЯ РАБОТЫ С КЛАССАМИ И СЕЛЕКТОРАМИ
112
- // ============================================================================
113
-
114
- // Генерация модификаторов для БЭМ
115
- @function generate-bem-modifiers($block, $modifiers...) {
116
- $result: ();
117
- @each $modifier in $modifiers {
118
- $result: append($result, $block + "--" + $modifier, comma);
119
- }
120
- @return $result;
121
- }
122
-
123
- // Генерация элементов для БЭМ
124
- @function generate-bem-elements($block, $elements...) {
125
- $result: ();
126
- @each $element in $elements {
127
- $result: append($result, $block + "__" + $element, comma);
128
- }
129
- @return $result;
130
- }
131
-
132
- // Создание селектора с состоянием
133
- @function with-state($selector, $state) {
134
- @return $selector + ":" + $state;
135
- }
136
-
137
- // Создание селектора с псевдоэлементом
138
- @function with-pseudo($selector, $pseudo) {
139
- @return $selector + "::" + $pseudo;
140
- }
141
-
142
- // ============================================================================
143
- // 11. ФУНКЦИИ ПАДИНГА И ВЫРАВНИВАНИЯ
144
- // ============================================================================
145
-
146
- // Дополнение строки слева
147
- @function string-pad-left($string, $length, $pad-char: " ") {
148
- @while string-length($string) < $length {
149
- $string: $pad-char + $string;
150
- }
151
- @return $string;
152
- }
153
-
154
- // Дополнение строки справа
155
- @function string-pad-right($string, $length, $pad-char: " ") {
156
- @while string-length($string) < $length {
157
- $string: $string + $pad-char;
158
- }
159
- @return $string;
160
- }
161
-
162
- // Дополнение строки с обеих сторон
163
- @function string-pad-both($string, $length, $pad-char: " ") {
164
- @while string-length($string) < $length {
165
- $string: $pad-char + $string + $pad-char;
166
- }
167
-
168
- // Если длина нечетная, удалить один символ справа
169
- @if string-length($string) > $length {
170
- $string: string.slice($string, 1, -2);
171
- }
172
-
173
- @return $string;
174
- }
175
-
176
- // Центрирование текста в указанной ширине
177
- @function string-center($string, $width, $pad-char: " ") {
178
- $string-length: string-length($string);
179
- @if $string-length >= $width {
180
- @return $string;
181
- }
182
-
183
- $padding: $width - $string-length;
184
- $left-padding: floor($padding / 2);
185
- $right-padding: $padding - $left-padding;
186
-
187
- $result: $string;
188
- @for $i from 1 through $left-padding {
189
- $result: $pad-char + $result;
190
- }
191
- @for $i from 1 through $right-padding {
192
- $result: $result + $pad-char;
193
- }
194
-
195
- @return $result;
196
- }
197
-
198
- // ============================================================================
199
- // 12. ФУНКЦИИ ПОВТОРЕНИЯ И ГЕНЕРАЦИИ
200
- // ============================================================================
201
-
202
- // Повторение строки указанное количество раз
203
- @function string-repeat($string, $times) {
204
- $result: "";
205
- @for $i from 1 through $times {
206
- $result: $result + $string;
207
- }
208
- @return $result;
209
- }
210
-
211
- // Генерация последовательности символов
212
- @function generate-sequence($start, $end) {
213
- $result: "";
214
- @for $i from $start through $end {
215
- $result: $result + string.slice("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789", $i, $i);
216
- }
217
- @return $result;
218
- }
219
-
220
- // Генерация Lorem Ipsum текста
221
- @function lorem-ipsum($words: 10) {
222
- $lorem-words: "lorem" "ipsum" "dolor" "sit" "amet" "consectetur" "adipiscing" "elit" "sed" "do"
223
- "eiusmod" "tempor" "incididunt" "ut" "labore" "et" "dolore" "magna" "aliqua" "ut"
224
- "enim" "ad" "minim" "veniam" "quis" "nostrud" "exercitation" "ullamco" "laboris"
225
- "nisi" "ut" "aliquip" "ex" "ea" "commodo" "consequat";
226
-
227
- $result: "";
228
- @for $i from 1 through $words {
229
- $word-index: ($i - 1) % length($lorem-words) + 1;
230
- $word: nth($lorem-words, $word-index);
231
- $result: $result + $word;
232
- @if $i != $words {
233
- $result: $result + " ";
234
- }
235
- }
236
-
237
- @return capitalize($result) + ".";
238
- }
239
-
240
- // ============================================================================
241
- // 13. ВСПОМОГАТЕЛЬНЫЕ И КОМБИНИРОВАННЫЕ ФУНКЦИИ
242
- // ============================================================================
243
-
244
- // Обращение строки
245
- @function string-reverse($string) {
246
- $result: "";
247
- $length: string-length($string);
248
-
249
- @for $i from $length through 1 {
250
- $result: $result + string.slice($string, $i, $i);
251
- }
252
-
253
- @return $result;
254
- }
255
-
256
- // Подсчет вхождений подстроки
257
- @function string-count($string, $substring) {
258
- $count: 0;
259
- $index: string-index($string, $substring);
260
-
261
- @while $index != null {
262
- $count: $count + 1;
263
- $string: string.slice($string, $index + string-length($substring));
264
- $index: string-index($string, $substring);
265
- }
266
-
267
- @return $count;
268
- }
269
-
270
- // Удаление всех пробелов
271
- @function remove-spaces($string) {
272
- @return string-replace($string, " ", "");
273
- }
274
-
275
- // Удаление всех указанных символов
276
- @function remove-chars($string, $chars) {
277
- @each $char in $chars {
278
- $string: string-replace($string, $char, "");
279
- }
280
- @return $string;
281
- }
282
-
283
- // Получение уникальных символов из строки
284
- @function unique-chars($string) {
285
- $result: "";
286
- $length: string-length($string);
287
-
288
- @for $i from 1 through $length {
289
- $char: string.slice($string, $i, $i);
290
- @if not contains($result, $char) {
291
- $result: $result + $char;
292
- }
293
- }
294
-
295
- @return $result;
296
- }
297
-
298
- // ============================================================================
299
- // 14. ФУНКЦИИ ДЛЯ РАБОТЫ С ЦВЕТАМИ (Строковые представления)
300
- // ============================================================================
301
-
302
- // Извлечение hex значения из строки цвета
303
- @function extract-hex($color-string) {
304
- $color-string: to-lower-case($color-string);
305
- $hash-index: string-index($color-string, "#");
306
-
307
- @if $hash-index {
308
- $hex-start: $hash-index + 1;
309
- $hex: string.slice($color-string, $hex-start);
310
-
311
- // Убираем все не-hex символы
312
- $hex: remove-chars($hex, (" ", ";", ")", "(", ","));
313
-
314
- @return "#" + $hex;
315
- }
316
-
317
- @return null;
318
- }
319
-
320
- // Проверка, является ли строка hex-цветом
321
- @function is-hex-color($string) {
322
- $string: to-lower-case(string-trim($string));
323
- @if not string-starts-with($string, "#") {
324
- @return false;
325
- }
326
-
327
- $hex: string.slice($string, 2);
328
- $hex-length: string-length($hex);
329
-
330
- @if $hex-length != 3 and $hex-length != 6 and $hex-length != 8 {
331
- @return false;
332
- }
333
-
334
- $valid-chars: "0123456789abcdef";
335
-
336
- @for $i from 1 through $hex-length {
337
- $char: string.slice($hex, $i, $i);
338
- @if not contains($valid-chars, $char) {
339
- @return false;
340
- }
341
- }
342
-
343
- @return true;
344
- }
345
-
346
- // ============================================================================
347
- // 15. ФУНКЦИИ ДЛЯ РАБОТЫ С МЕДИА-ЗАПРОСАМИ
348
- // ============================================================================
349
-
350
- // Создание медиа-запроса с минимальной шириной
351
- @function min-width-query($width) {
352
- @return "(min-width: " + $width + ")";
353
- }
354
-
355
- // Создание медиа-запроса с максимальной шириной
356
- @function max-width-query($width) {
357
- @return "(max-width: " + $width + ")";
358
- }
359
-
360
- // Создание медиа-запроса для диапазона ширины
361
- @function width-range-query($min, $max) {
362
- @return "(min-width: " + $min + ") and (max-width: " + $max + ")";
363
- }
364
-
365
- // ============================================================================
366
- // ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ
367
- // ============================================================================
368
-
369
- /*
370
- // Примеры использования функций:
371
-
372
- // 1. Базовые операции
373
- $test: "Hello World";
374
- $length: string-length($test); // 11
375
- $upper: to-upper-case($test); // "HELLO WORLD"
376
- $substr: string.slice($test, 7, 11); // "World"
377
-
378
- // 2. Проверки
379
- $has-world: contains($test, "World"); // true
380
- $starts-hello: string-starts-with($test, "Hello"); // true
381
- $ends-world: string-ends-with($test, "World"); // true
382
-
383
- // 3. Обрезка
384
- $trimmed: string-trim(" Hello "); // "Hello"
385
-
386
- // 4. Замена
387
- $replaced: string-replace($test, "World", "Sass"); // "Hello Sass"
388
-
389
- // 5. Преобразование регистра
390
- $kebab: camel-to-kebab("helloWorld"); // "hello-world"
391
- $camel: kebab-to-camel("hello-world"); // "helloWorld"
392
-
393
- // 6. Работа с CSS значениями
394
- $unit: get-unit("10px"); // "px"
395
- $number: get-number("10px"); // 10
396
- $no-unit: strip-unit("10px"); // 10
397
-
398
- // 7. Генерация классов
399
- $modifiers: generate-bem-modifiers("button", "primary", "large");
400
- // ".button--primary, .button--large"
401
- */
402
-
403
- // ============================================================================
404
- // КОНЕЦ БИБЛИОТЕКИ ФУНКЦИЙ ДЛЯ РАБОТЫ СО СТРОКАМИ
405
- // ============================================================================
package/test.sh DELETED
@@ -1,149 +0,0 @@
1
- #!/usr/bin/env bash
2
-
3
- # Conventional Commit с использованием fzf
4
- # Убедитесь, что fzf установлен: brew install fzf, apt-get install fzf, или pacman -S fzf
5
-
6
- # Проверяем, есть ли изменения для коммита
7
- if [ -z "$(git status --porcelain)" ]; then
8
- echo "❌ Нет изменений для коммита"
9
- exit 1
10
- fi
11
-
12
- # Цвета для лучшего отображения
13
- RED='\033[0;31m'
14
- GREEN='\033[0;32m'
15
- YELLOW='\033[1;33m'
16
- BLUE='\033[0;34m'
17
- NC='\033[0m' # No Color
18
-
19
- # Функция для отображения заголовков
20
- header() {
21
- echo -e "${BLUE}=== $1 ===${NC}"
22
- }
23
-
24
- # Выбор типа коммита
25
- header "Тип коммита"
26
- TYPE=$(printf "feat: Новая функциональность
27
- fix: Исправление ошибки
28
- docs: Изменения в документации
29
- style: Форматирование, точки с запятой, пробелы
30
- refactor: Рефакторинг без изменения функциональности
31
- perf: Изменения для улучшения производительности
32
- test: Добавление или исправление тестов
33
- build: Изменения в системе сборки
34
- ci: Изменения в CI-конфигурации
35
- chore: Обновление зависимостей, рутинные задачи
36
- revert: Отмена предыдущего коммита" | fzf --height=50% --border=rounded \
37
- --header="Выберите тип коммита (↑↓ для навигации, Enter для выбора)" \
38
- --preview="echo -e '${GREEN}Пример:${NC}\n{1}: краткое описание\n\n${YELLOW}Сгенерирует:${NC}\n{1}: ваш текст'" | cut -d: -f1)
39
-
40
- if [ -z "$TYPE" ]; then
41
- echo "❌ Отменено пользователем"
42
- exit 0
43
- fi
44
-
45
- # Выбор области (scope)
46
- header "Область изменений"
47
- SCOPE=$(echo -e " \ngeneral\napi\nui\nauth\ndb\nconfig\ntests\ncli\ndocs\nbuild\ndeploy\nmobile\ndesktop\nserver\nclient\nfrontend\nbackend" | \
48
- fzf --height=40% --border=rounded --print-query \
49
- --header="Введите область или выберите из списка (Enter без ввода = без области)" | tail -1)
50
-
51
- SCOPE=$(echo "$SCOPE" | xargs) # Убираем лишние пробелы
52
-
53
- if [ -n "$SCOPE" ] && [ "$SCOPE" != " " ] && [ "$SCOPE" != "general" ]; then
54
- SCOPE="($SCOPE)"
55
- else
56
- SCOPE=""
57
- fi
58
-
59
- # Breaking change?
60
- header "Breaking Change"
61
- BREAKING=$(printf "Нет\nДа" | fzf --height=30% --border=rounded \
62
- --header="Это изменение ломает обратную совместимость?")
63
-
64
- if [ "$BREAKING" = "Да" ]; then
65
- BREAKING_CHAR="!"
66
-
67
- header "Описание Breaking Change"
68
- BREAKING_DESC=$(echo "" | fzf --height=10 --border=rounded --print-query \
69
- --header="Опишите что именно изменилось и как адаптировать код" | tail -1)
70
-
71
- if [ -z "$BREAKING_DESC" ] || [ "$BREAKING_DESC" = " " ]; then
72
- echo -e "${YELLOW}⚠️ Breaking change описан кратко${NC}"
73
- BREAKING_DESC="Изменен API/интерфейс, требуется обновление кода"
74
- fi
75
- else
76
- BREAKING_CHAR=""
77
- BREAKING_DESC=""
78
- fi
79
-
80
- # Краткое описание
81
- header "Краткое описание"
82
- DESCRIPTION=$(echo "" | fzf --height=10 --border=rounded --print-query \
83
- --header="Краткое описание (используйте повелительное наклонение, например: 'добавить', 'исправить', 'обновить')" | tail -1)
84
-
85
- # Проверка описания
86
- if [ -z "$DESCRIPTION" ] || [ "$DESCRIPTION" = " " ]; then
87
- echo -e "${RED}❌ Описание обязательно!${NC}"
88
- exit 1
89
- fi
90
-
91
- # Детальное описание (опционально)
92
- header "Детальное описание"
93
- echo -e "${YELLOW}Нажмите Ctrl+D для завершения ввода (или оставьте пустым)${NC}"
94
- echo "Введите детальное описание изменений:"
95
- BODY=""
96
- while IFS= read -r line; do
97
- if [ -z "$BODY" ]; then
98
- BODY="$line"
99
- else
100
- BODY="$BODY\n$line"
101
- fi
102
- done
103
-
104
- # Предпросмотр
105
- header "Предпросмотр коммита"
106
- FINAL_MESSAGE="$TYPE$SCOPE$BREAKING_CHAR: $DESCRIPTION"
107
-
108
- if [ -n "$BODY" ] && [ "$BODY" != " " ]; then
109
- FINAL_MESSAGE="$FINAL_MESSAGE\n\n$BODY"
110
- fi
111
-
112
- if [ -n "$BREAKING_DESC" ]; then
113
- if [ -n "$BODY" ] && [ "$BODY" != " " ]; then
114
- FINAL_MESSAGE="$FINAL_MESSAGE\n\n"
115
- else
116
- FINAL_MESSAGE="$FINAL_MESSAGE\n"
117
- fi
118
- FINAL_MESSAGE="$FINAL_MESSAGE\nBREAKING CHANGE: $BREAKING_DESC"
119
- fi
120
-
121
- echo -e "${GREEN}Сообщение коммита:${NC}"
122
- echo -e "------------------------------"
123
- echo -e "$FINAL_MESSAGE"
124
- echo -e "------------------------------"
125
-
126
- # Подтверждение
127
- header "Подтверждение"
128
- CONFIRM=$(printf "✅ Создать коммит\n❌ Отменить" | fzf --height=30% --border=rounded \
129
- --header="Все верно? (Enter для подтверждения)")
130
-
131
- if [[ "$CONFIRM" != "✅ Создать коммит" ]]; then
132
- echo -e "${YELLOW}❌ Отменено${NC}"
133
- exit 0
134
- fi
135
-
136
- # Создание коммита
137
- echo -e "$FINAL_MESSAGE" | git commit -F -
138
-
139
- # Проверка результата
140
- if [ $? -eq 0 ]; then
141
- echo -e "${GREEN}✅ Коммит успешно создан!${NC}"
142
-
143
- # Показываем последний коммит
144
- echo -e "\n${YELLOW}Последний коммит:${NC}"
145
- git log --oneline -1
146
- else
147
- echo -e "${RED}❌ Ошибка при создании коммита${NC}"
148
- exit 1
149
- fi