Initial commit

packages/utils/src/helpers/Readme.md

@@ -0,0 +1,41 @@
+# [←](../../Readme.md) Огляд Хелперів
+
+### # downloadFileByLink(href: string, name?: string, target?: string): void
+
+Програмно завантажує файл за URL, створюючи тимчасовий `<a>` елемент і клікаючи по ньому.
+
+```ts
+downloadFileByLink('https://example.com/file.pdf', 'report'); // завантажує як 'report'
+```
+
+---
+
+### # sleep(ms: number): Promise\<void>
+
+Затримує виконання на задану кількість мілісекунд.
+
+```ts
+await sleep(1000); // чекає 1 секунду
+```
+
+---
+
+### # throttle(func, limit: number): Function
+
+Обмежує частоту виклику функції — не частіше ніж раз на `limit` мс.
+
+```ts
+const throttled = throttle(onScroll, 200);
+window.addEventListener('scroll', throttled);
+```
+
+---
+
+### # debounce\<T>(func: T, wait: number): Function
+
+Відкладає виклик функції до закінчення `wait` мс після останнього виклику.
+
+```ts
+const debounced = debounce(onSearch, 300);
+input.addEventListener('input', debounced);
+```