@mirta/basics 0.0.6 → 0.1.0

package/dist/index.d.ts

@@ -26,9 +26,10 @@ declare const isString: (value: unknown) => value is string;
 declare const isNumber: (value: unknown) => value is number;
 /** Сужает диапазон множества типов до boolean */
 declare const isBoolean: (value: unknown) => value is boolean;
+declare const isFunction: (value: unknown) => value is ((...args: unknown[]) => unknown);
 
-type EventHandler<TArgs> = (args: TArgs) => void;
-interface Event<TArgs> {
+type EventHandler = (...args: unknown[]) => void;
+interface Event<THandler extends EventHandler> {
     /**
      * Подписывает на событие, есть возможность отписки.
      * @example
@@ -41,7 +42,7 @@ interface Event<TArgs> {
      * subscription.off()
      * ```
      **/
-    on: (handler: EventHandler<TArgs>) => {
+    on: (handler: THandler) => {
         off: () => void;
     };
     /**
@@ -54,7 +55,7 @@ interface Event<TArgs> {
      * stateChanged.once(() => { ... })
      * ```
      **/
-    once: (handler: EventHandler<TArgs>) => void;
+    once: (handler: THandler) => void;
     /**
      * Отписывает указанный обработчик от прослушивания события.
      * @example
@@ -69,7 +70,9 @@ interface Event<TArgs> {
      * stateChanged.off(handler)
      * ```
      **/
-    off: (handler: EventHandler<TArgs>) => void;
+    off: (handler: THandler) => void;
+}
+interface EventRaiser<THandler extends EventHandler> extends Event<THandler> {
     /**
      * Объявляет всем подписчикам о наступлении события.
      * @example
@@ -80,7 +83,8 @@ interface Event<TArgs> {
      * stateChanged.raise()
      * ```
      **/
-    raise: (args: TArgs) => void;
+    raise: (...args: Parameters<THandler>) => void;
+    withoutRaise: () => Event<THandler>;
 }
 /**
  * Построитель экземпляра события.
@@ -103,7 +107,7 @@ interface Event<TArgs> {
  * countChanged.raise(100)
  * ```
  */
-declare function useEvent<TArgs = void>(): Event<TArgs>;
+declare function useEvent<THandler extends EventHandler>(): EventRaiser<THandler>;
 
-export { debounce, isBoolean, isNumber, isString, throttle, useEvent };
-export type { Event, EventHandler };
+export { debounce, isBoolean, isFunction, isNumber, isString, throttle, useEvent };
+export type { Event, EventHandler, EventRaiser };

package/dist/index.mjs

@@ -97,6 +97,7 @@ const isString = (value) => typeof value === 'string';
 const isNumber = (value) => typeof value === 'number';
 /** Сужает диапазон множества типов до boolean */
 const isBoolean = (value) => typeof value === 'boolean';
+const isFunction = (value) => typeof value === 'function';
 
 /**
  * Построитель экземпляра события.
@@ -136,24 +137,29 @@ function useEvent() {
         };
     }
     function once(handler) {
-        const wrapper = (args) => {
-            handler(args);
+        const wrapper = ((...args) => {
+            handler(...args);
             off(wrapper);
-        };
+        });
         handlers.push(wrapper);
     }
-    function raise(args) {
+    const raise = (...args) => {
         // Защита от сдвига в массиве при выполнении once.
         const handlersCopy = handlers.concat();
         for (let i = 0, len = handlersCopy.length; i < len; i++)
-            (handlersCopy[i])(args);
-    }
+            (handlersCopy[i])(...args);
+    };
     return {
         on,
         once,
         off,
         raise,
+        withoutRaise: () => ({
+            on,
+            once,
+            off,
+        }),
     };
 }
 
-export { debounce, isBoolean, isNumber, isString, throttle, useEvent };
+export { debounce, isBoolean, isFunction, isNumber, isString, throttle, useEvent };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mirta/basics",
   "description": "Utility functions providing core functionality for the Mirta Framework.",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "license": "Unlicense",
   "keywords": [
     "mirta",