@alwatr/signal 0.29.0 → 0.30.0

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.30.0](https://github.com/AliMD/alwatr/compare/v0.29.0...v0.30.0) (2023-03-06)
+
+### Bug Fixes
+
+- **signal:** NextCycle with own detail ([01f3c79](https://github.com/AliMD/alwatr/commit/01f3c79500927f6384a33abcc9b0cb2355794b3e))
+- **signal:** nodejs compatibility ([69d8a60](https://github.com/AliMD/alwatr/commit/69d8a60ad64d44ee7c3ced002e702f13408a5a50))
+- **signal:** requestableContextConsumer bind issue ([66467f6](https://github.com/AliMD/alwatr/commit/66467f6e5681d84d7f2e0b353206d4bb579b26f2))
+- **signal:** requestContext dispatch issue ([e937ebd](https://github.com/AliMD/alwatr/commit/e937ebd3a90fc6a9946f5c35ef4f6f40b6ab4b00))
+
+### Features
+
+- **signal:** add untilChange for contextProvider ([cb44916](https://github.com/AliMD/alwatr/commit/cb4491698fd5ddfbe055032fc2cb50691de31194))
+- **signal:** defineCommand return ListenerSpec ([21fecac](https://github.com/AliMD/alwatr/commit/21fecacb6aa9423da9e3c177a4bbc59952d94e35))
+- **signal:** dispatch NextCycle option ([b30eb31](https://github.com/AliMD/alwatr/commit/b30eb316d92f594034fc40d195c4033e38e4d2e2))
+
 # [0.29.0](https://github.com/AliMD/alwatr/compare/v0.28.0...v0.29.0) (2023-02-10)
 
 ### Bug Fixes

package/command-handler.d.ts

@@ -20,6 +20,6 @@ export declare const commandHandler: {
      */
     readonly define: <TArgument extends import("@alwatr/type").StringifyableRecord, TReturn extends import("@alwatr/type").Stringifyable>(signalId: string, signalProvider: import("./type.js").ProviderFunction<TArgument & {
         _callbackSignalId?: string | undefined;
-    }, TReturn>, options?: Partial<Pick<import("./type.js").ProviderOptions, "debounce">>) => void;
+    }, TReturn>, options?: Partial<Pick<import("./type.js").ProviderOptions, "debounce">>) => import("./type.js").ListenerSpec;
 };
 //# sourceMappingURL=command-handler.d.ts.map

package/context-provider.d.ts

@@ -42,6 +42,16 @@ export declare const contextProvider: {
      * ```
      */
     readonly expire: (signalId: string) => void;
+    /**
+     * Waits until the context value changes.
+     *
+     * Example:
+     *
+     * ```ts
+     * const newProductList = await contextProvider.untilChange<ProductListType>('product-list');
+     * ```
+     */
+    readonly untilChange: <T_2 extends Stringifyable>(signalId: string) => Promise<T_2>;
     /**
      * Bind this interface to special context.
      *
@@ -51,7 +61,7 @@ export declare const contextProvider: {
      * const productListProvider = contextProvider.bind<ProductListType>('product-list');
      * ```
      */
-    readonly bind: <T_2 extends Stringifyable>(contextId: string) => {
+    readonly bind: <T_3 extends Stringifyable>(contextId: string) => {
         /**
          * Context signal Id.
          */
@@ -70,7 +80,7 @@ export declare const contextProvider: {
          * }
          * ```
          */
-        readonly getValue: () => T_2 | undefined;
+        readonly getValue: () => T_3 | undefined;
         /**
          * Set context value and send signal to all consumers.
          *
@@ -82,7 +92,7 @@ export declare const contextProvider: {
          * productListProvider.setValue(newProductList);
          * ```
          */
-        readonly setValue: (detail: T_2, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
+        readonly setValue: (detail: T_3, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
         /**
          * Clear current context value without send signal to all consumers.
          *
@@ -95,6 +105,16 @@ export declare const contextProvider: {
          * ```
          */
         readonly expire: () => void;
+        /**
+         * Waits until the context value changes.
+         *
+         * Example:
+         *
+         * ```ts
+         * const newProductList = await productListProvider.untilChange();
+         * ```
+         */
+        readonly untilChange: () => Promise<T_3>;
     };
 };
 //# sourceMappingURL=context-provider.d.ts.map

package/context-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-provider.d.ts","sourceRoot":"","sources":["src/context-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;OAQG;0DACwC,MAAM;QAC/C;;WAEG;;QAGH;;;;;;;;;;;;;WAaG;;QAGH;;;;;;;;;;WAUG;;QAGH;;;;;;;;;;WAUG;;;CAGG,CAAC"}
+{"version":3,"file":"context-provider.d.ts","sourceRoot":"","sources":["src/context-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;0DACwC,MAAM;QAC/C;;WAEG;;QAGH;;;;;;;;;;;;;WAaG;;QAGH;;;;;;;;;;WAUG;;QAGH;;;;;;;;;;WAUG;;QAGH;;;;;;;;WAQG;;;CAGG,CAAC"}

package/context-provider.js

@@ -1,4 +1,4 @@
-import { clearDetail, dispatch, getDetail } from './core.js';
+import { clearDetail, dispatch, getDetail, untilNext } from './core.js';
 /**
  * Context provider interface.
  */
@@ -42,6 +42,16 @@ export const contextProvider = {
      * ```
      */
     expire: clearDetail,
+    /**
+     * Waits until the context value changes.
+     *
+     * Example:
+     *
+     * ```ts
+     * const newProductList = await contextProvider.untilChange<ProductListType>('product-list');
+     * ```
+     */
+    untilChange: untilNext,
     /**
      * Bind this interface to special context.
      *
@@ -95,6 +105,16 @@ export const contextProvider = {
          * ```
          */
         expire: clearDetail.bind(null, contextId),
+        /**
+         * Waits until the context value changes.
+         *
+         * Example:
+         *
+         * ```ts
+         * const newProductList = await productListProvider.untilChange();
+         * ```
+         */
+        untilChange: untilNext.bind(null, contextId),
     }),
 };
 //# sourceMappingURL=context-provider.js.map

package/context-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-provider.js","sourceRoot":"","sources":["src/context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAI3D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,SAAS;IAEnB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,QAAQ;IAElB;;;;;;;;;;OAUG;IACH,MAAM,EAAE,WAAW;IAEnB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAA0B,SAAiB,EAAE,EAAE,CAAA,CAAC;QACpD;;WAEG;QACH,EAAE,EAAE,SAAS;QAEb;;;;;;;;;;;;;WAaG;QACH,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAwC;QAEhF;;;;;;;;;;WAUG;QACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAuC;QAE9E;;;;;;;;;;WAUG;QACH,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;KAChC,CAAA;CACH,CAAC","sourcesContent":["import {clearDetail, dispatch, getDetail} from './core.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Context provider interface.\n */\nexport const contextProvider = {\n  /**\n   * Get context value.\n   *\n   * Return undefined if context not set before or expired.\n   *\n   * Example:\n   *\n   * ```ts\n   * const currentProductList = contextProvider.getValue<ProductListType>('product-list');\n   * if (currentProductList === undefined) {\n   *   // productList not set before or expired.\n   * }\n   * ```\n   */\n  getValue: getDetail,\n\n  /**\n   * Set context value and send signal to all consumers.\n   *\n   * Signal detail changed immediately without any debounce.\n   *\n   * Example:\n   *\n   * ```ts\n   * contextProvider.setValue<ProductListType>('product-list', newProductList);\n   * ```\n   */\n  setValue: dispatch,\n\n  /**\n   * Clear current context value without send signal to all consumers.\n   *\n   * new subscriber options.receivePrevious not work until new signal\n   *\n   * Example:\n   *\n   * ```ts\n   * contextProvider.expire('product-list');\n   * ```\n   */\n  expire: clearDetail,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListProvider = contextProvider.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <T extends Stringifyable>(contextId: string) =>({\n    /**\n     * Context signal Id.\n     */\n    id: contextId,\n\n    /**\n     * Get context value.\n     *\n     * Return undefined if context not set before or expired.\n     *\n     * Example:\n     *\n     * ```ts\n     * const currentProductList = productListProvider.getValue();\n     * if (currentProductList === undefined) {\n     *   // productList not set before or expired.\n     * }\n     * ```\n     */\n    getValue: getDetail.bind(null, contextId) as OmitFirstParam<typeof getDetail<T>>,\n\n    /**\n     * Set context value and send signal to all consumers.\n     *\n     * Signal detail changed immediately without any debounce.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.setValue(newProductList);\n     * ```\n     */\n    setValue: dispatch.bind(null, contextId) as OmitFirstParam<typeof dispatch<T>>,\n\n    /**\n     * Clear current context value without send signal to all consumers.\n     *\n     * new subscriber options.receivePrevious not work until new signal\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.expire();\n     * ```\n     */\n    expire: clearDetail.bind(null, contextId),\n  } as const),\n} as const;\n"]}
+{"version":3,"file":"context-provider.js","sourceRoot":"","sources":["src/context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAItE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,SAAS;IAEnB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,QAAQ;IAElB;;;;;;;;;;OAUG;IACH,MAAM,EAAE,WAAW;IAEnB;;;;;;;;OAQG;IACH,WAAW,EAAE,SAAS;IAEtB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAA0B,SAAiB,EAAE,EAAE,CAAA,CAAC;QACpD;;WAEG;QACH,EAAE,EAAE,SAAS;QAEb;;;;;;;;;;;;;WAaG;QACH,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAwC;QAEhF;;;;;;;;;;WAUG;QACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAuC;QAE9E;;;;;;;;;;WAUG;QACH,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAEzC;;;;;;;;WAQG;QACH,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAwC;KAC1E,CAAA;CACH,CAAC","sourcesContent":["import {clearDetail, dispatch, getDetail, untilNext} from './core.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Context provider interface.\n */\nexport const contextProvider = {\n  /**\n   * Get context value.\n   *\n   * Return undefined if context not set before or expired.\n   *\n   * Example:\n   *\n   * ```ts\n   * const currentProductList = contextProvider.getValue<ProductListType>('product-list');\n   * if (currentProductList === undefined) {\n   *   // productList not set before or expired.\n   * }\n   * ```\n   */\n  getValue: getDetail,\n\n  /**\n   * Set context value and send signal to all consumers.\n   *\n   * Signal detail changed immediately without any debounce.\n   *\n   * Example:\n   *\n   * ```ts\n   * contextProvider.setValue<ProductListType>('product-list', newProductList);\n   * ```\n   */\n  setValue: dispatch,\n\n  /**\n   * Clear current context value without send signal to all consumers.\n   *\n   * new subscriber options.receivePrevious not work until new signal\n   *\n   * Example:\n   *\n   * ```ts\n   * contextProvider.expire('product-list');\n   * ```\n   */\n  expire: clearDetail,\n\n  /**\n   * Waits until the context value changes.\n   *\n   * Example:\n   *\n   * ```ts\n   * const newProductList = await contextProvider.untilChange<ProductListType>('product-list');\n   * ```\n   */\n  untilChange: untilNext,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListProvider = contextProvider.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <T extends Stringifyable>(contextId: string) =>({\n    /**\n     * Context signal Id.\n     */\n    id: contextId,\n\n    /**\n     * Get context value.\n     *\n     * Return undefined if context not set before or expired.\n     *\n     * Example:\n     *\n     * ```ts\n     * const currentProductList = productListProvider.getValue();\n     * if (currentProductList === undefined) {\n     *   // productList not set before or expired.\n     * }\n     * ```\n     */\n    getValue: getDetail.bind(null, contextId) as OmitFirstParam<typeof getDetail<T>>,\n\n    /**\n     * Set context value and send signal to all consumers.\n     *\n     * Signal detail changed immediately without any debounce.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.setValue(newProductList);\n     * ```\n     */\n    setValue: dispatch.bind(null, contextId) as OmitFirstParam<typeof dispatch<T>>,\n\n    /**\n     * Clear current context value without send signal to all consumers.\n     *\n     * new subscriber options.receivePrevious not work until new signal\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.expire();\n     * ```\n     */\n    expire: clearDetail.bind(null, contextId),\n\n    /**\n     * Waits until the context value changes.\n     *\n     * Example:\n     *\n     * ```ts\n     * const newProductList = await productListProvider.untilChange();\n     * ```\n     */\n    untilChange: untilNext.bind(null, contextId) as OmitFirstParam<typeof untilNext<T>>,\n  } as const),\n} as const;\n"]}

package/core.d.ts

@@ -19,7 +19,7 @@ export declare const getSignalObject: <T extends Stringifyable>(id: string) => S
  *
  * Used inside dispatch, Don't use it directly.
  */
-export declare const _callListeners: <T extends Stringifyable>(signal: SignalObject<T>) => void;
+export declare const _callListeners: <T extends Stringifyable>(signal: SignalObject<T>, detail: T) => void;
 /**
  * Subscribe new signal listener to a signal, work like addEventListener.
  *
@@ -120,7 +120,7 @@ export declare const setContextProvider: <TContext extends Stringifyable, TRques
  */
 export declare const defineCommand: <TArgument extends StringifyableRecord, TReturn extends Stringifyable>(signalId: string, signalProvider: ProviderFunction<TArgument & {
     _callbackSignalId?: string | undefined;
-}, TReturn>, options?: Partial<Pick<ProviderOptions, 'debounce'>>) => void;
+}, TReturn>, options?: Partial<Pick<ProviderOptions, 'debounce'>>) => ListenerSpec;
 /**
  * Dispatch request context signal with requestParam as detail.
  *

package/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEhB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAmBrE,eAAO,MAAM,MAAM,uCAAgC,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,gCAAiC,MAAM,oBAWlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,wDAAuD,IAiCjF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,sCACV,MAAM,mDAEP,QAAQ,gBAAgB,CAAC,KACjC,YAuDF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,aAAc,YAAY,KAAG,IAOpD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,aAAc,MAAM,KAAG,IAMrD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,sCACT,MAAM,uBAEP,QAAQ,eAAe,CAAC,KAChC,IA2BF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,sCAAuC,MAAM,kBAElE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,sCAAuC,MAAM,eASlE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,4EACnB,MAAM,wEAEP,QAAQ,eAAe,CAAC,KAChC,IAkBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,mFACd,MAAM;;uBAEP,QAAQ,KAAK,eAAe,EAAE,UAAU,CAAC,CAAC,KAClD,IAuBF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,8CACd,MAAM,oCAER,QAAQ,eAAe,CAAC,KAChC,IAGF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,qDACd,MAAM,iCAEhB,IAGF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,oFAI1B,MAAM,iDAqBlB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,aAAc,MAAM,KAAG,IAI9C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,aAAc,MAAM,KAAG,IAMhD,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEhB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACb,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAmBrE,eAAO,MAAM,MAAM,uCAAgC,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,gCAAiC,MAAM,oBAWlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,mEAAkE,IA0B5F,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,sCACV,MAAM,mDAEP,QAAQ,gBAAgB,CAAC,KACjC,YAuDF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,aAAc,YAAY,KAAG,IAOpD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,aAAc,MAAM,KAAG,IAMrD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,sCACT,MAAM,uBAEP,QAAQ,eAAe,CAAC,KAChC,IAoCF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,sCAAuC,MAAM,kBAElE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,sCAAuC,MAAM,eASlE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,4EACnB,MAAM,wEAEP,QAAQ,eAAe,CAAC,KAChC,IAkBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,mFACd,MAAM;;uBAEP,QAAQ,KAAK,eAAe,EAAE,UAAU,CAAC,CAAC,KAClD,YAuBF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,8CACd,MAAM,oCAER,QAAQ,eAAe,CAAC,KAChC,IAGF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,qDACd,MAAM,iCAEhB,IAGF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,oFAI1B,MAAM,iDAqBlB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,aAAc,MAAM,KAAG,IAI9C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,aAAc,MAAM,KAAG,IAMhD,CAAC"}

package/core.js

@@ -1,4 +1,5 @@
 import { createLogger, globalAlwatr } from '@alwatr/logger';
+import { requestAnimationFrame } from '@alwatr/util';
 globalAlwatr.registeredList.push({
     name: '@alwatr/signal',
     version: _ALWATR_VERSION_,
@@ -42,14 +43,8 @@ export const getSignalObject = (id) => {
  *
  * Used inside dispatch, Don't use it directly.
  */
-export const _callListeners = (signal) => {
-    logger.logMethodArgs('_callListeners', { signalId: signal.id, signalDetail: signal.detail });
-    if (signal.detail === undefined) {
-        logger.accident('_callListeners', 'no_signal_detail', 'signal must have a detail', {
-            signalId: signal.id,
-        });
-        return;
-    }
+export const _callListeners = (signal, detail) => {
+    logger.logMethodArgs('_callListeners', { signalId: signal.id, signalDetail: detail });
     const removeList = [];
     for (const listener of signal.listenerList) {
         if (listener.disabled)
@@ -57,7 +52,7 @@ export const _callListeners = (signal) => {
         if (listener.once)
             removeList.push(listener);
         try {
-            const ret = listener.callback(signal.detail);
+            const ret = listener.callback(detail);
             if (ret instanceof Promise) {
                 ret.catch((err) => logger.error('_callListeners', 'call_listener_failed', err, {
                     signalId: signal.id,
@@ -87,7 +82,7 @@ export const subscribe = (signalId, listenerCallback, options = {}) => {
     var _a, _b, _c, _d;
     (_a = options.once) !== null && _a !== void 0 ? _a : (options.once = false);
     (_b = options.disabled) !== null && _b !== void 0 ? _b : (options.disabled = false);
-    (_c = options.receivePrevious) !== null && _c !== void 0 ? _c : (options.receivePrevious = 'AnimationFrame');
+    (_c = options.receivePrevious) !== null && _c !== void 0 ? _c : (options.receivePrevious = 'NextCycle');
     (_d = options.priority) !== null && _d !== void 0 ? _d : (options.priority = false);
     logger.logMethodArgs('subscribe', { signalId, options });
     const signal = getSignalObject(signalId);
@@ -189,16 +184,23 @@ export const dispatch = (signalId, detail, options = {}) => {
     signal.detail = detail;
     if (signal.disabled)
         return; // signal is disabled.
-    // Simple debounce noise filtering
-    if (options.debounce !== 'No' && signal.debounced === true)
-        return; // last dispatch in progress.
     if (options.debounce === 'No') {
-        return _callListeners(signal);
+        return _callListeners(signal, detail);
+    }
+    // else
+    if (options.debounce === 'NextCycle') {
+        setTimeout(_callListeners, 0, signal, detail);
+        return;
+    }
+    // else
+    if (signal.debounced === true) {
+        return; // last dispatch in progress.
     }
     // else
     signal.debounced = true;
     const callListeners = () => {
-        _callListeners(signal);
+        var _a;
+        _callListeners(signal, (_a = signal.detail) !== null && _a !== void 0 ? _a : detail);
         signal.debounced = false;
     };
     options.debounce === 'AnimationFrame'
@@ -289,7 +291,7 @@ export const defineCommand = (signalId, signalProvider, options = {}) => {
     logger.logMethodArgs('defineCommand', { commandId: signalId, options });
     const requestSignalId = 'request-' + signalId;
     removeAllListeners(requestSignalId);
-    subscribe(requestSignalId, async (argumentObject) => {
+    return subscribe(requestSignalId, async (argumentObject) => {
         clearDetail(requestSignalId); // clean argumentObject from memory
         if (argumentObject._callbackSignalId == null) {
             signalProvider(argumentObject);
@@ -312,7 +314,7 @@ export const defineCommand = (signalId, signalProvider, options = {}) => {
  */
 export const requestContext = (contextId, requestParam, options = {}) => {
     logger.logMethodArgs('requestContext', { contextId, requestParam });
-    return dispatch(contextId, requestParam, options);
+    return dispatch(`request-${contextId}`, requestParam, options);
 };
 /**
  * Dispatch request command signal with commandArgument as detail.
@@ -346,7 +348,7 @@ export const requestCommandWithResponse = async (commandId, commandArgument) =>
     dispatch(_requestSignalId, {
         ...commandArgument,
         _callbackSignalId,
-    }, { debounce: 'No' });
+    }, { debounce: 'NextCycle' });
     const response = await untilCallback;
     destroySignal(_callbackSignalId);
     return response;

package/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"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","sourcesContent":["import {createLogger, globalAlwatr} from '@alwatr/logger';\n\nimport type {\n  DispatchOptions,\n  ListenerFunction,\n  ListenerObject,\n  SubscribeOptions,\n  SignalObject,\n  ProviderFunction,\n  ProviderOptions,\n  SignalStorage,\n  ListenerSpec,\n} from './type.js';\nimport type {Stringifyable, StringifyableRecord} from '@alwatr/type';\n\nglobalAlwatr.registeredList.push({\n  name: '@alwatr/signal',\n  version: _ALWATR_VERSION_,\n});\n\n/**\n * Listener `id`\n */\nlet _lastListenerAutoId = 0;\n\nconst debounceTimeout = 5;\n\n/**\n * Signal stack database.\n */\nconst _signalStorage: SignalStorage = {};\n\nexport const logger = createLogger('alwatr/signal');\n\n/**\n * Get signal object by id, If not available, it will create a new signal with default options.\n *\n * Don't use it directly.\n *\n * Example:\n *\n * ```ts\n * const signal = getSignalObject<ContentType>('content-change');\n * signal.disabled = true;\n * ```\n */\nexport const getSignalObject = <T extends Stringifyable>(id: string): SignalObject<T> => {\n  let signal = _signalStorage[id] as SignalObject<T> | undefined;\n  if (signal == null) {\n    signal = _signalStorage[id] = {\n      id,\n      disabled: false,\n      debounced: false,\n      listenerList: [],\n    };\n  }\n  return signal;\n};\n\n/**\n * Call all listeners callback of special signal.\n *\n * Used inside dispatch, Don't use it directly.\n */\nexport const _callListeners = <T extends Stringifyable>(signal: SignalObject<T>): void => {\n  logger.logMethodArgs('_callListeners', {signalId: signal.id, signalDetail: signal.detail});\n\n  if (signal.detail === undefined) {\n    logger.accident('_callListeners', 'no_signal_detail', 'signal must have a detail', {\n      signalId: signal.id,\n    });\n    return;\n  }\n\n  const removeList: Array<ListenerObject<T>> = [];\n\n  for (const listener of signal.listenerList) {\n    if (listener.disabled) continue;\n    if (listener.once) removeList.push(listener);\n    try {\n      const ret = listener.callback(signal.detail);\n      if (ret instanceof Promise) {\n        ret.catch((err) =>\n          logger.error('_callListeners', 'call_listener_failed', err, {\n            signalId: signal.id,\n          }),\n        );\n      }\n    }\n    catch (err) {\n      logger.error('_callListeners', 'call_listener_failed', err, {\n        signalId: signal.id,\n      });\n    }\n  }\n\n  removeList.forEach((listener) => unsubscribe(listener));\n};\n\n/**\n * Subscribe new signal listener to a signal, work like addEventListener.\n *\n * Example:\n *\n * ```ts\n * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));\n * // ...\n * unsubscribe(listener);\n * ```\n */\nexport const subscribe = <T extends Stringifyable>(\n  signalId: string,\n  listenerCallback: ListenerFunction<T>,\n  options: Partial<SubscribeOptions> = {},\n): ListenerSpec => {\n  options.once ??= false;\n  options.disabled ??= false;\n  options.receivePrevious ??= 'AnimationFrame';\n  options.priority ??= false;\n\n  logger.logMethodArgs('subscribe', {signalId, options});\n\n  const signal = getSignalObject<T>(signalId);\n\n  const listener: ListenerObject<T> = {\n    id: ++_lastListenerAutoId,\n    signalId: signal.id,\n    once: options.once,\n    disabled: options.disabled,\n    callback: listenerCallback,\n  };\n\n  const callbackCall = signal.detail !== undefined && options.receivePrevious !== 'No';\n  if (callbackCall) {\n    // Run callback for old dispatch signal\n\n    const callback = (): void => {\n      try {\n        if (signal.detail !== undefined) listenerCallback(signal.detail);\n      }\n      catch (err) {\n        logger.error('subscribe', 'call_signal_callback_failed', err, {\n          signalId: signal.id,\n        });\n      }\n    };\n\n    if (options.receivePrevious === 'AnimationFrame') {\n      requestAnimationFrame(callback);\n    }\n    else {\n      setTimeout(callback, options.receivePrevious === 'NextCycle' ? 0 : debounceTimeout);\n    }\n  }\n\n  // if once then must remove listener after fist callback called! then why push it to listenerList?!\n  if (!(callbackCall && options.once)) {\n    if (options.priority === true) {\n      signal.listenerList.unshift(listener);\n    }\n    else {\n      signal.listenerList.push(listener);\n    }\n  }\n\n  return {\n    id: listener.id,\n    signalId: listener.signalId,\n  };\n};\n\n/**\n * Unsubscribe listener from signal, work like removeEventListener.\n *\n * Example:\n *\n * ```ts\n * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));\n * // ...\n * unsubscribe(listener);\n * ```\n */\nexport const unsubscribe = (listener: ListenerSpec): void => {\n  logger.logMethodArgs('unsubscribe', listener);\n  const signal = getSignalObject(listener.signalId);\n  const listenerIndex = signal.listenerList.findIndex((_listener) => _listener.id === listener.id);\n  if (listenerIndex !== -1) {\n    void signal.listenerList.splice(listenerIndex, 1);\n  }\n};\n\n/**\n * Unsubscribe all listener from a signal, clear all listeners.\n *\n * Example:\n *\n * ```ts\n * removeAllListeners('content-change');\n * ```\n */\nexport const removeAllListeners = (signalId: string): void => {\n  logger.logMethodArgs('removeAllListeners', signalId);\n  const signal = getSignalObject(signalId);\n  if (signal.listenerList.length === 0) return;\n  signal.listenerList.length = 0;\n  signal.listenerList = [];\n};\n\n/**\n * Dispatch (send) signal to all listeners.\n *\n * Signal detail changed immediately without any debounce.\n *\n * Example:\n *\n * ```ts\n * dispatch<ContentType>('content-change', newContent);\n * ```\n */\nexport const dispatch = <T extends Stringifyable>(\n  signalId: string,\n  detail: T,\n  options: Partial<DispatchOptions> = {},\n): void => {\n  options.debounce ??= 'AnimationFrame';\n\n  logger.logMethodArgs('dispatch', {signalId, detail, options});\n\n  const signal = getSignalObject<T>(signalId);\n\n  // set detail before check signal.debounced for act like throttle (call listeners with last dispatch detail).\n  signal.detail = detail;\n\n  if (signal.disabled) return; // signal is disabled.\n\n  // Simple debounce noise filtering\n  if (options.debounce !== 'No' && signal.debounced === true) return; // last dispatch in progress.\n\n  if (options.debounce === 'No') {\n    return _callListeners(signal);\n  }\n  // else\n  signal.debounced = true;\n  const callListeners = (): void => {\n    _callListeners(signal);\n    signal.debounced = false;\n  };\n  options.debounce === 'AnimationFrame'\n    ? requestAnimationFrame(callListeners)\n    : setTimeout(callListeners, debounceTimeout);\n};\n\n/**\n * Get current signal detail/value.\n *\n * Return undefined if signal not dispatched before or expired.\n *\n * Example:\n *\n * ```ts\n * const currentContent = getDetail<ContentType>('content-change');\n * if (currentContent === undefined) {\n *   // signal not dispatched yet\n * }\n * ```\n */\nexport const getDetail = <T extends Stringifyable>(signalId: string): T | undefined => {\n  return getSignalObject<T>(signalId).detail;\n};\n\n/**\n * Get the detail/value of the next received signal.\n *\n * Example:\n *\n * ```ts\n * const newContent = await untilNext<ContentType>('content-change');\n * ```\n */\nexport const untilNext = <T extends Stringifyable>(signalId: string): Promise<T> => {\n  return new Promise((resolve) => {\n    logger.logMethodArgs('untilNext', signalId);\n    subscribe<T>(signalId, resolve, {\n      once: true,\n      priority: true,\n      receivePrevious: 'No',\n    });\n  });\n};\n\n/**\n * Defines the provider of the context signal that will be called when the context requested.\n * Subscribe to `request-signalId`.\n *\n * Example:\n *\n * ```ts\n * setContextProvider('content-change', async (requestParam) => await fetchNewContent(requestParam));\n * ```\n */\nexport const setContextProvider = <TContext extends Stringifyable, TRquest extends Stringifyable>(\n  signalId: string,\n  signalProvider: ProviderFunction<TRquest, TContext | void>,\n  options: Partial<ProviderOptions> = {},\n): void => {\n  options.debounce ??= 'AnimationFrame';\n  options.receivePrevious ??= 'AnimationFrame';\n  logger.logMethodArgs('setContextProvider', {signalId, options});\n  const requestSignalId = 'request-' + signalId;\n  removeAllListeners(requestSignalId);\n  subscribe<TRquest>(\n      requestSignalId,\n      async (argumentObject): Promise<void> => {\n        const signalDetail = await signalProvider(argumentObject);\n        if (signalDetail !== undefined) {\n          dispatch<TContext>(signalId, signalDetail, {debounce: options.debounce});\n        }\n      },\n      {\n        receivePrevious: options.receivePrevious,\n      },\n  );\n};\n\n/**\n * Defines the command and dispatch returned value.\n *\n * Subscribe commandFunction to request-command-signal and dispatch callback-signal with commandFunction return value.\n *\n * Example:\n *\n * ```ts\n * defineCommand<TArgument, TReturn>(\n *   'show-prompt',\n *   async (argumentObject) => {\n *      return await showPrompt(argumentObject);\n *   },\n * );\n * ```\n */\nexport const defineCommand = <TArgument extends StringifyableRecord, TReturn extends Stringifyable>(\n  signalId: string,\n  signalProvider: ProviderFunction<TArgument & {_callbackSignalId?: string}, TReturn>,\n  options: Partial<Pick<ProviderOptions, 'debounce'>> = {},\n): void => {\n  options.debounce ??= 'AnimationFrame';\n  logger.logMethodArgs('defineCommand', {commandId: signalId, options});\n  const requestSignalId = 'request-' + signalId;\n  removeAllListeners(requestSignalId);\n  subscribe<TArgument & {_callbackSignalId?: string}>(\n      requestSignalId,\n      async (argumentObject) => {\n        clearDetail(requestSignalId); // clean argumentObject from memory\n        if (argumentObject._callbackSignalId == null) {\n          signalProvider(argumentObject);\n        }\n        else {\n          // prettier-ignore\n          dispatch<TReturn>(\n              argumentObject._callbackSignalId,\n              await signalProvider(argumentObject),\n              {debounce: options.debounce},\n          );\n        }\n      },\n      {receivePrevious: 'NextCycle'},\n  );\n};\n\n/**\n * Dispatch request context signal with requestParam as detail.\n *\n * Example:\n *\n * ```ts\n * requestContext<RequestParamType>('content-change', {foo: 'bar'});\n * const newContent = await untilNext<ContentType>('content-change');\n * ```\n */\nexport const requestContext = <TRequest extends Stringifyable>(\n  contextId: string,\n  requestParam: TRequest,\n  options: Partial<DispatchOptions> = {},\n): void => {\n  logger.logMethodArgs('requestContext', {contextId, requestParam});\n  return dispatch<TRequest>(contextId, requestParam, options);\n};\n\n/**\n * Dispatch request command signal with commandArgument as detail.\n *\n * Example:\n *\n * ```ts\n * requestCommand<ArgumentType>('show-dialog', {foo: 'bar'});\n * ```\n */\nexport const requestCommand = <TArgument extends StringifyableRecord>(\n  commandId: string,\n  commandArgument: TArgument,\n): void => {\n  logger.logMethodArgs('requestCommand', {commandId, commandArgument});\n  dispatch<TArgument>(`request-${commandId}`, commandArgument, {debounce: 'No'});\n};\n\n/**\n * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.\n *\n * Request command and wait for answer.\n *\n * Example:\n *\n * ```ts\n * const response = await requestCommandWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});\n * ```\n */\nexport const requestCommandWithResponse = async <\n  TArgument extends StringifyableRecord,\n  TReturn extends Stringifyable\n>(\n  commandId: string,\n  commandArgument: TArgument,\n): Promise<TReturn> => {\n  logger.logMethodArgs('requestCommand', {commandId, commandArgument});\n\n  const _requestSignalId = `request-${commandId}`;\n  const _callbackSignalId = `callback-${commandId}-${++_lastListenerAutoId}`;\n  const untilCallback = untilNext<TReturn>(_callbackSignalId);\n\n  dispatch<TArgument & {_callbackSignalId: string}>(\n      _requestSignalId,\n      {\n        ...commandArgument,\n        _callbackSignalId,\n      },\n      {debounce: 'No'},\n  );\n\n  const response = await untilCallback;\n  destroySignal(_callbackSignalId);\n  return response;\n};\n\n/**\n * Clear current signal detail without dispatch new signal.\n *\n * new subscriber options.receivePrevious not work until new signal\n *\n * Example:\n *\n * ```ts\n * clearDetail('product-list');\n * ```\n */\nexport const clearDetail = (signalId: string): void => {\n  logger.logMethodArgs('expire', signalId);\n  const signal = getSignalObject(signalId);\n  delete signal.detail;\n};\n\n/**\n * Delete signal object with detail and listeners and options.\n *\n * new subscriber options.receivePrevious not work until new signal\n *\n * Example:\n *\n * ```ts\n * destroySignal('product-list');\n * ```\n */\nexport const destroySignal = (signalId: string): void => {\n  logger.logMethodArgs('destroySignal', signalId);\n  const signal = _signalStorage[signalId];\n  if (signal == null) return;\n  signal.listenerList.length = 0;\n  delete _signalStorage[signalId];\n};\n"]}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAC,qBAAqB,EAAC,MAAM,cAAc,CAAC;AAenD,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;IAC/B,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAE5B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,cAAc,GAAkB,EAAE,CAAC;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAA0B,EAAU,EAAmB,EAAE;IACtF,IAAI,MAAM,GAAG,cAAc,CAAC,EAAE,CAAgC,CAAC;IAC/D,IAAI,MAAM,IAAI,IAAI,EAAE;QAClB,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC,GAAG;YAC5B,EAAE;YACF,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,EAAE;SACjB,CAAC;KACH;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAA0B,MAAuB,EAAE,MAAS,EAAQ,EAAE;IAClG,MAAM,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAC,CAAC,CAAC;IAEpF,MAAM,UAAU,GAA6B,EAAE,CAAC;IAEhD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,YAAY,EAAE;QAC1C,IAAI,QAAQ,CAAC,QAAQ;YAAE,SAAS;QAChC,IAAI,QAAQ,CAAC,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI;YACF,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,GAAG,YAAY,OAAO,EAAE;gBAC1B,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAChB,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,GAAG,EAAE;oBAC1D,QAAQ,EAAE,MAAM,CAAC,EAAE;iBACpB,CAAC,CACH,CAAC;aACH;SACF;QACD,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,GAAG,EAAE;gBAC1D,QAAQ,EAAE,MAAM,CAAC,EAAE;aACpB,CAAC,CAAC;SACJ;KACF;IAED,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAChB,gBAAqC,EACrC,UAAqC,EAAE,EACzB,EAAE;;IAChB,MAAA,OAAO,CAAC,IAAI,oCAAZ,OAAO,CAAC,IAAI,GAAK,KAAK,EAAC;IACvB,MAAA,OAAO,CAAC,QAAQ,oCAAhB,OAAO,CAAC,QAAQ,GAAK,KAAK,EAAC;IAC3B,MAAA,OAAO,CAAC,eAAe,oCAAvB,OAAO,CAAC,eAAe,GAAK,WAAW,EAAC;IACxC,MAAA,OAAO,CAAC,QAAQ,oCAAhB,OAAO,CAAC,QAAQ,GAAK,KAAK,EAAC;IAE3B,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAC,QAAQ,EAAE,OAAO,EAAC,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,eAAe,CAAI,QAAQ,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAsB;QAClC,EAAE,EAAE,EAAE,mBAAmB;QACzB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,gBAAgB;KAC3B,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC;IACrF,IAAI,YAAY,EAAE;QAChB,uCAAuC;QAEvC,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,IAAI;gBACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;oBAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aAClE;YACD,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,6BAA6B,EAAE,GAAG,EAAE;oBAC5D,QAAQ,EAAE,MAAM,CAAC,EAAE;iBACpB,CAAC,CAAC;aACJ;QACH,CAAC,CAAC;QAEF,IAAI,OAAO,CAAC,eAAe,KAAK,gBAAgB,EAAE;YAChD,qBAAqB,CAAC,QAAQ,CAAC,CAAC;SACjC;aACI;YACH,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;SACrF;KACF;IAED,mGAAmG;IACnG,IAAI,CAAC,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE;QACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE;YAC7B,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SACvC;aACI;YACH,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SACpC;KACF;IAED,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAsB,EAAQ,EAAE;IAC1D,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjG,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;QACxB,KAAK,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;KACnD;AACH,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAQ,EAAE;IAC3D,MAAM,CAAC,aAAa,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7C,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,QAAgB,EAChB,MAAS,EACT,UAAoC,EAAE,EAChC,EAAE;;IACR,MAAA,OAAO,CAAC,QAAQ,oCAAhB,OAAO,CAAC,QAAQ,GAAK,gBAAgB,EAAC;IAEtC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAC,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,eAAe,CAAI,QAAQ,CAAC,CAAC;IAE5C,6GAA6G;IAC7G,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IAEvB,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,sBAAsB;IAEnD,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE;QAC7B,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC;IAED,OAAO;IACP,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE;QACpC,UAAU,CAAC,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO;KACR;IAED,OAAO;IACP,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE;QAC7B,OAAO,CAAC,6BAA6B;KACtC;IAED,OAAO;IACP,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,MAAM,aAAa,GAAG,GAAS,EAAE;;QAC/B,cAAc,CAAC,MAAM,EAAE,MAAA,MAAM,CAAC,MAAM,mCAAI,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO,CAAC,QAAQ,KAAK,gBAAgB;QACnC,CAAC,CAAC,qBAAqB,CAAC,aAAa,CAAC;QACtC,CAAC,CAAC,UAAU,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAA0B,QAAgB,EAAiB,EAAE;IACpF,OAAO,eAAe,CAAI,QAAQ,CAAC,CAAC,MAAM,CAAC;AAC7C,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAA0B,QAAgB,EAAc,EAAE;IACjF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC5C,SAAS,CAAI,QAAQ,EAAE,OAAO,EAAE;YAC9B,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,IAAI;YACd,eAAe,EAAE,IAAI;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,QAAgB,EAChB,cAA0D,EAC1D,UAAoC,EAAE,EAChC,EAAE;;IACR,MAAA,OAAO,CAAC,QAAQ,oCAAhB,OAAO,CAAC,QAAQ,GAAK,gBAAgB,EAAC;IACtC,MAAA,OAAO,CAAC,eAAe,oCAAvB,OAAO,CAAC,eAAe,GAAK,gBAAgB,EAAC;IAC7C,MAAM,CAAC,aAAa,CAAC,oBAAoB,EAAE,EAAC,QAAQ,EAAE,OAAO,EAAC,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC9C,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpC,SAAS,CACL,eAAe,EACf,KAAK,EAAE,cAAc,EAAiB,EAAE;QACtC,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,CAAC;QAC1D,IAAI,YAAY,KAAK,SAAS,EAAE;YAC9B,QAAQ,CAAW,QAAQ,EAAE,YAAY,EAAE,EAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAC,CAAC,CAAC;SAC1E;IACH,CAAC,EACD;QACE,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAAgB,EAChB,cAAmF,EACnF,UAAsD,EAAE,EAC1C,EAAE;;IAChB,MAAA,OAAO,CAAC,QAAQ,oCAAhB,OAAO,CAAC,QAAQ,GAAK,gBAAgB,EAAC;IACtC,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,EAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAC,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC9C,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,SAAS,CACZ,eAAe,EACf,KAAK,EAAE,cAAc,EAAE,EAAE;QACvB,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,mCAAmC;QACjE,IAAI,cAAc,CAAC,iBAAiB,IAAI,IAAI,EAAE;YAC5C,cAAc,CAAC,cAAc,CAAC,CAAC;SAChC;aACI;YACH,kBAAkB;YAClB,QAAQ,CACJ,cAAc,CAAC,iBAAiB,EAChC,MAAM,cAAc,CAAC,cAAc,CAAC,EACpC,EAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAC,CAC/B,CAAC;SACH;IACH,CAAC,EACD,EAAC,eAAe,EAAE,WAAW,EAAC,CACjC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAiB,EACjB,YAAsB,EACtB,UAAoC,EAAE,EAChC,EAAE;IACR,MAAM,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAC,SAAS,EAAE,YAAY,EAAC,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAW,WAAW,SAAS,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,SAAiB,EACjB,eAA0B,EACpB,EAAE;IACR,MAAM,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAC,SAAS,EAAE,eAAe,EAAC,CAAC,CAAC;IACrE,QAAQ,CAAY,WAAW,SAAS,EAAE,EAAE,eAAe,EAAE,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAI7C,SAAiB,EACjB,eAA0B,EACR,EAAE;IACpB,MAAM,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAC,SAAS,EAAE,eAAe,EAAC,CAAC,CAAC;IAErE,MAAM,gBAAgB,GAAG,WAAW,SAAS,EAAE,CAAC;IAChD,MAAM,iBAAiB,GAAG,YAAY,SAAS,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC3E,MAAM,aAAa,GAAG,SAAS,CAAU,iBAAiB,CAAC,CAAC;IAE5D,QAAQ,CACJ,gBAAgB,EAChB;QACE,GAAG,eAAe;QAClB,iBAAiB;KAClB,EACD,EAAC,QAAQ,EAAE,WAAW,EAAC,CAC1B,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;IACrC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAQ,EAAE;IACpD,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAQ,EAAE;IACtD,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO;IAC3B,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import {createLogger, globalAlwatr} from '@alwatr/logger';\nimport {requestAnimationFrame} from '@alwatr/util';\n\nimport type {\n  DispatchOptions,\n  ListenerFunction,\n  ListenerObject,\n  SubscribeOptions,\n  SignalObject,\n  ProviderFunction,\n  ProviderOptions,\n  SignalStorage,\n  ListenerSpec,\n} from './type.js';\nimport type {Stringifyable, StringifyableRecord} from '@alwatr/type';\n\nglobalAlwatr.registeredList.push({\n  name: '@alwatr/signal',\n  version: _ALWATR_VERSION_,\n});\n\n/**\n * Listener `id`\n */\nlet _lastListenerAutoId = 0;\n\nconst debounceTimeout = 5;\n\n/**\n * Signal stack database.\n */\nconst _signalStorage: SignalStorage = {};\n\nexport const logger = createLogger('alwatr/signal');\n\n/**\n * Get signal object by id, If not available, it will create a new signal with default options.\n *\n * Don't use it directly.\n *\n * Example:\n *\n * ```ts\n * const signal = getSignalObject<ContentType>('content-change');\n * signal.disabled = true;\n * ```\n */\nexport const getSignalObject = <T extends Stringifyable>(id: string): SignalObject<T> => {\n  let signal = _signalStorage[id] as SignalObject<T> | undefined;\n  if (signal == null) {\n    signal = _signalStorage[id] = {\n      id,\n      disabled: false,\n      debounced: false,\n      listenerList: [],\n    };\n  }\n  return signal;\n};\n\n/**\n * Call all listeners callback of special signal.\n *\n * Used inside dispatch, Don't use it directly.\n */\nexport const _callListeners = <T extends Stringifyable>(signal: SignalObject<T>, detail: T): void => {\n  logger.logMethodArgs('_callListeners', {signalId: signal.id, signalDetail: detail});\n\n  const removeList: Array<ListenerObject<T>> = [];\n\n  for (const listener of signal.listenerList) {\n    if (listener.disabled) continue;\n    if (listener.once) removeList.push(listener);\n    try {\n      const ret = listener.callback(detail);\n      if (ret instanceof Promise) {\n        ret.catch((err) =>\n          logger.error('_callListeners', 'call_listener_failed', err, {\n            signalId: signal.id,\n          }),\n        );\n      }\n    }\n    catch (err) {\n      logger.error('_callListeners', 'call_listener_failed', err, {\n        signalId: signal.id,\n      });\n    }\n  }\n\n  removeList.forEach((listener) => unsubscribe(listener));\n};\n\n/**\n * Subscribe new signal listener to a signal, work like addEventListener.\n *\n * Example:\n *\n * ```ts\n * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));\n * // ...\n * unsubscribe(listener);\n * ```\n */\nexport const subscribe = <T extends Stringifyable>(\n  signalId: string,\n  listenerCallback: ListenerFunction<T>,\n  options: Partial<SubscribeOptions> = {},\n): ListenerSpec => {\n  options.once ??= false;\n  options.disabled ??= false;\n  options.receivePrevious ??= 'NextCycle';\n  options.priority ??= false;\n\n  logger.logMethodArgs('subscribe', {signalId, options});\n\n  const signal = getSignalObject<T>(signalId);\n\n  const listener: ListenerObject<T> = {\n    id: ++_lastListenerAutoId,\n    signalId: signal.id,\n    once: options.once,\n    disabled: options.disabled,\n    callback: listenerCallback,\n  };\n\n  const callbackCall = signal.detail !== undefined && options.receivePrevious !== 'No';\n  if (callbackCall) {\n    // Run callback for old dispatch signal\n\n    const callback = (): void => {\n      try {\n        if (signal.detail !== undefined) listenerCallback(signal.detail);\n      }\n      catch (err) {\n        logger.error('subscribe', 'call_signal_callback_failed', err, {\n          signalId: signal.id,\n        });\n      }\n    };\n\n    if (options.receivePrevious === 'AnimationFrame') {\n      requestAnimationFrame(callback);\n    }\n    else {\n      setTimeout(callback, options.receivePrevious === 'NextCycle' ? 0 : debounceTimeout);\n    }\n  }\n\n  // if once then must remove listener after fist callback called! then why push it to listenerList?!\n  if (!(callbackCall && options.once)) {\n    if (options.priority === true) {\n      signal.listenerList.unshift(listener);\n    }\n    else {\n      signal.listenerList.push(listener);\n    }\n  }\n\n  return {\n    id: listener.id,\n    signalId: listener.signalId,\n  };\n};\n\n/**\n * Unsubscribe listener from signal, work like removeEventListener.\n *\n * Example:\n *\n * ```ts\n * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));\n * // ...\n * unsubscribe(listener);\n * ```\n */\nexport const unsubscribe = (listener: ListenerSpec): void => {\n  logger.logMethodArgs('unsubscribe', listener);\n  const signal = getSignalObject(listener.signalId);\n  const listenerIndex = signal.listenerList.findIndex((_listener) => _listener.id === listener.id);\n  if (listenerIndex !== -1) {\n    void signal.listenerList.splice(listenerIndex, 1);\n  }\n};\n\n/**\n * Unsubscribe all listener from a signal, clear all listeners.\n *\n * Example:\n *\n * ```ts\n * removeAllListeners('content-change');\n * ```\n */\nexport const removeAllListeners = (signalId: string): void => {\n  logger.logMethodArgs('removeAllListeners', signalId);\n  const signal = getSignalObject(signalId);\n  if (signal.listenerList.length === 0) return;\n  signal.listenerList.length = 0;\n  signal.listenerList = [];\n};\n\n/**\n * Dispatch (send) signal to all listeners.\n *\n * Signal detail changed immediately without any debounce.\n *\n * Example:\n *\n * ```ts\n * dispatch<ContentType>('content-change', newContent);\n * ```\n */\nexport const dispatch = <T extends Stringifyable>(\n  signalId: string,\n  detail: T,\n  options: Partial<DispatchOptions> = {},\n): void => {\n  options.debounce ??= 'AnimationFrame';\n\n  logger.logMethodArgs('dispatch', {signalId, detail, options});\n\n  const signal = getSignalObject<T>(signalId);\n\n  // set detail before check signal.debounced for act like throttle (call listeners with last dispatch detail).\n  signal.detail = detail;\n\n  if (signal.disabled) return; // signal is disabled.\n\n  if (options.debounce === 'No') {\n    return _callListeners(signal, detail);\n  }\n\n  // else\n  if (options.debounce === 'NextCycle') {\n    setTimeout(_callListeners, 0, signal, detail);\n    return;\n  }\n\n  // else\n  if (signal.debounced === true) {\n    return; // last dispatch in progress.\n  }\n\n  // else\n  signal.debounced = true;\n  const callListeners = (): void => {\n    _callListeners(signal, signal.detail ?? detail);\n    signal.debounced = false;\n  };\n  options.debounce === 'AnimationFrame'\n    ? requestAnimationFrame(callListeners)\n    : setTimeout(callListeners, debounceTimeout);\n};\n\n/**\n * Get current signal detail/value.\n *\n * Return undefined if signal not dispatched before or expired.\n *\n * Example:\n *\n * ```ts\n * const currentContent = getDetail<ContentType>('content-change');\n * if (currentContent === undefined) {\n *   // signal not dispatched yet\n * }\n * ```\n */\nexport const getDetail = <T extends Stringifyable>(signalId: string): T | undefined => {\n  return getSignalObject<T>(signalId).detail;\n};\n\n/**\n * Get the detail/value of the next received signal.\n *\n * Example:\n *\n * ```ts\n * const newContent = await untilNext<ContentType>('content-change');\n * ```\n */\nexport const untilNext = <T extends Stringifyable>(signalId: string): Promise<T> => {\n  return new Promise((resolve) => {\n    logger.logMethodArgs('untilNext', signalId);\n    subscribe<T>(signalId, resolve, {\n      once: true,\n      priority: true,\n      receivePrevious: 'No',\n    });\n  });\n};\n\n/**\n * Defines the provider of the context signal that will be called when the context requested.\n * Subscribe to `request-signalId`.\n *\n * Example:\n *\n * ```ts\n * setContextProvider('content-change', async (requestParam) => await fetchNewContent(requestParam));\n * ```\n */\nexport const setContextProvider = <TContext extends Stringifyable, TRquest extends Stringifyable>(\n  signalId: string,\n  signalProvider: ProviderFunction<TRquest, TContext | void>,\n  options: Partial<ProviderOptions> = {},\n): void => {\n  options.debounce ??= 'AnimationFrame';\n  options.receivePrevious ??= 'AnimationFrame';\n  logger.logMethodArgs('setContextProvider', {signalId, options});\n  const requestSignalId = 'request-' + signalId;\n  removeAllListeners(requestSignalId);\n  subscribe<TRquest>(\n      requestSignalId,\n      async (argumentObject): Promise<void> => {\n        const signalDetail = await signalProvider(argumentObject);\n        if (signalDetail !== undefined) {\n          dispatch<TContext>(signalId, signalDetail, {debounce: options.debounce});\n        }\n      },\n      {\n        receivePrevious: options.receivePrevious,\n      },\n  );\n};\n\n/**\n * Defines the command and dispatch returned value.\n *\n * Subscribe commandFunction to request-command-signal and dispatch callback-signal with commandFunction return value.\n *\n * Example:\n *\n * ```ts\n * defineCommand<TArgument, TReturn>(\n *   'show-prompt',\n *   async (argumentObject) => {\n *      return await showPrompt(argumentObject);\n *   },\n * );\n * ```\n */\nexport const defineCommand = <TArgument extends StringifyableRecord, TReturn extends Stringifyable>(\n  signalId: string,\n  signalProvider: ProviderFunction<TArgument & {_callbackSignalId?: string}, TReturn>,\n  options: Partial<Pick<ProviderOptions, 'debounce'>> = {},\n): ListenerSpec => {\n  options.debounce ??= 'AnimationFrame';\n  logger.logMethodArgs('defineCommand', {commandId: signalId, options});\n  const requestSignalId = 'request-' + signalId;\n  removeAllListeners(requestSignalId);\n  return subscribe<TArgument & {_callbackSignalId?: string}>(\n      requestSignalId,\n      async (argumentObject) => {\n        clearDetail(requestSignalId); // clean argumentObject from memory\n        if (argumentObject._callbackSignalId == null) {\n          signalProvider(argumentObject);\n        }\n        else {\n          // prettier-ignore\n          dispatch<TReturn>(\n              argumentObject._callbackSignalId,\n              await signalProvider(argumentObject),\n              {debounce: options.debounce},\n          );\n        }\n      },\n      {receivePrevious: 'NextCycle'},\n  );\n};\n\n/**\n * Dispatch request context signal with requestParam as detail.\n *\n * Example:\n *\n * ```ts\n * requestContext<RequestParamType>('content-change', {foo: 'bar'});\n * const newContent = await untilNext<ContentType>('content-change');\n * ```\n */\nexport const requestContext = <TRequest extends Stringifyable>(\n  contextId: string,\n  requestParam: TRequest,\n  options: Partial<DispatchOptions> = {},\n): void => {\n  logger.logMethodArgs('requestContext', {contextId, requestParam});\n  return dispatch<TRequest>(`request-${contextId}`, requestParam, options);\n};\n\n/**\n * Dispatch request command signal with commandArgument as detail.\n *\n * Example:\n *\n * ```ts\n * requestCommand<ArgumentType>('show-dialog', {foo: 'bar'});\n * ```\n */\nexport const requestCommand = <TArgument extends StringifyableRecord>(\n  commandId: string,\n  commandArgument: TArgument,\n): void => {\n  logger.logMethodArgs('requestCommand', {commandId, commandArgument});\n  dispatch<TArgument>(`request-${commandId}`, commandArgument, {debounce: 'No'});\n};\n\n/**\n * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.\n *\n * Request command and wait for answer.\n *\n * Example:\n *\n * ```ts\n * const response = await requestCommandWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});\n * ```\n */\nexport const requestCommandWithResponse = async <\n  TArgument extends StringifyableRecord,\n  TReturn extends Stringifyable\n>(\n  commandId: string,\n  commandArgument: TArgument,\n): Promise<TReturn> => {\n  logger.logMethodArgs('requestCommand', {commandId, commandArgument});\n\n  const _requestSignalId = `request-${commandId}`;\n  const _callbackSignalId = `callback-${commandId}-${++_lastListenerAutoId}`;\n  const untilCallback = untilNext<TReturn>(_callbackSignalId);\n\n  dispatch<TArgument & {_callbackSignalId: string}>(\n      _requestSignalId,\n      {\n        ...commandArgument,\n        _callbackSignalId,\n      },\n      {debounce: 'NextCycle'},\n  );\n\n  const response = await untilCallback;\n  destroySignal(_callbackSignalId);\n  return response;\n};\n\n/**\n * Clear current signal detail without dispatch new signal.\n *\n * new subscriber options.receivePrevious not work until new signal\n *\n * Example:\n *\n * ```ts\n * clearDetail('product-list');\n * ```\n */\nexport const clearDetail = (signalId: string): void => {\n  logger.logMethodArgs('expire', signalId);\n  const signal = getSignalObject(signalId);\n  delete signal.detail;\n};\n\n/**\n * Delete signal object with detail and listeners and options.\n *\n * new subscriber options.receivePrevious not work until new signal\n *\n * Example:\n *\n * ```ts\n * destroySignal('product-list');\n * ```\n */\nexport const destroySignal = (signalId: string): void => {\n  logger.logMethodArgs('destroySignal', signalId);\n  const signal = _signalStorage[signalId];\n  if (signal == null) return;\n  signal.listenerList.length = 0;\n  delete _signalStorage[signalId];\n};\n"]}

package/index.d.ts

@@ -6,5 +6,5 @@ export * from './event-listener.js';
 export * from './event-trigger.js';
 export * from './requestable-context-consumer.js';
 export * from './requestable-context-provider.js';
-export type { ListenerSpec } from './type.js';
+export type { ListenerSpec, DebounceType, DispatchOptions } from './type.js';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,YAAY,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,YAAY,EAAC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAC,MAAM,WAAW,CAAC"}

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAGlD;;;;;;;EAOE","sourcesContent":["export * from './command-handler.js';\nexport * from './command-trigger.js';\nexport * from './context-consumer.js';\nexport * from './context-provider.js';\nexport * from './event-listener.js';\nexport * from './event-trigger.js';\nexport * from './requestable-context-consumer.js';\nexport * from './requestable-context-provider.js';\nexport type {ListenerSpec} from './type.js';\n\n/*\nTODO:\n  1. change signal option like disable\n  2. Get signal value without undefined\n    (Get signal value from last dispatched signal (if any) or wait for new signal received.)\n  3. dispatched bool\n  4. optional commandProvider debounce\n*/\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAGlD;;;;;;;EAOE","sourcesContent":["export * from './command-handler.js';\nexport * from './command-trigger.js';\nexport * from './context-consumer.js';\nexport * from './context-provider.js';\nexport * from './event-listener.js';\nexport * from './event-trigger.js';\nexport * from './requestable-context-consumer.js';\nexport * from './requestable-context-provider.js';\nexport type {ListenerSpec, DebounceType, DispatchOptions} from './type.js';\n\n/*\nTODO:\n  1. change signal option like disable\n  2. Get signal value without undefined\n    (Get signal value from last dispatched signal (if any) or wait for new signal received.)\n  3. dispatched bool\n  4. optional commandProvider debounce\n*/\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwatr/signal",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Elegant powerful event system for handle global signals and states written in tiny TypeScript module.",
   "keywords": [
     "signal",
@@ -29,8 +29,10 @@
     "url": "https://github.com/AliMD/alwatr/issues"
   },
   "dependencies": {
-    "@alwatr/logger": "^0.29.0",
+    "@alwatr/logger": "^0.30.0",
+    "@alwatr/type": "^0.30.0",
+    "@alwatr/util": "^0.30.0",
     "tslib": "^2.5.0"
   },
-  "gitHead": "801487f183f8afd8cba25e0fec5d508c0b4fe809"
+  "gitHead": "36f55780ccdcb1acc07400b0cdb3fe7b0df56cca"
 }

package/requestable-context-consumer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestable-context-consumer.d.ts","sourceRoot":"","sources":["src/requestable-context-consumer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAI,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;8FAC8E,MAAM;QAGrF;;;;;;;;;WASG;;;;;;;;;;;;CAIG,CAAC"}
+{"version":3,"file":"requestable-context-consumer.d.ts","sourceRoot":"","sources":["src/requestable-context-consumer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;8FAC8E,MAAM;QAGrF;;;;;;;;;WASG;;;;;;;;;;;;CAIG,CAAC"}

package/requestable-context-consumer.js

@@ -37,7 +37,7 @@ export const requestableContextConsumer = {
          * const newProductList = await productListConsumer.untilChange();
          * ```
          */
-        request: requestContext,
+        request: requestContext.bind(null, contextId),
     }),
 };
 //# sourceMappingURL=requestable-context-consumer.js.map

package/requestable-context-consumer.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestable-context-consumer.js","sourceRoot":"","sources":["src/requestable-context-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAIzC;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,eAAe;IAElB;;;;;;;;;OASG;IACH,OAAO,EAAE,cAAc;IAEvB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAgE,SAAiB,EAAE,EAAE,CAAA,CAAC;QAC1F,GAAG,eAAe,CAAC,IAAI,CAAW,SAAS,CAAC;QAE5C;;;;;;;;;WASG;QACH,OAAO,EAAE,cACuC;KACvC,CAAA;CACH,CAAC","sourcesContent":["import {contextConsumer} from './context-consumer.js';\nimport {requestContext} from './core.js';\n\nimport type{Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Requestable context consumer interface.\n */\nexport const requestableContextConsumer = {\n  ...contextConsumer,\n\n  /**\n   * Send new context request to the provider.\n   *\n   * Example:\n   *\n   * ```ts\n   * requestableContextConsumer.request<RequestParamType>('product-list', {foo: 'bar'});\n   * const newProductList = await requestableContextConsumer.untilChange<ProductListType>('product-list');\n   * ```\n   */\n  request: requestContext,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListConsumer = requestableContextConsumer.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <TContext extends Stringifyable, TRquest extends Stringifyable>(contextId: string) =>({\n    ...contextConsumer.bind<TContext>(contextId),\n\n    /**\n     * Send new context request to the provider.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListConsumer.request({foo: 'bar'});\n     * const newProductList = await productListConsumer.untilChange();\n     * ```\n     */\n    request: requestContext as\n      OmitFirstParam<typeof requestContext<TRquest>>,\n  } as const),\n} as const;\n"]}
+{"version":3,"file":"requestable-context-consumer.js","sourceRoot":"","sources":["src/requestable-context-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAIzC;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,eAAe;IAElB;;;;;;;;;OASG;IACH,OAAO,EAAE,cAAc;IAEvB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAgE,SAAiB,EAAE,EAAE,CAAA,CAAC;QAC1F,GAAG,eAAe,CAAC,IAAI,CAAW,SAAS,CAAC;QAE5C;;;;;;;;;WASG;QACH,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACI;KACvC,CAAA;CACH,CAAC","sourcesContent":["import {contextConsumer} from './context-consumer.js';\nimport {requestContext} from './core.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Requestable context consumer interface.\n */\nexport const requestableContextConsumer = {\n  ...contextConsumer,\n\n  /**\n   * Send new context request to the provider.\n   *\n   * Example:\n   *\n   * ```ts\n   * requestableContextConsumer.request<RequestParamType>('product-list', {foo: 'bar'});\n   * const newProductList = await requestableContextConsumer.untilChange<ProductListType>('product-list');\n   * ```\n   */\n  request: requestContext,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListConsumer = requestableContextConsumer.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <TContext extends Stringifyable, TRquest extends Stringifyable>(contextId: string) =>({\n    ...contextConsumer.bind<TContext>(contextId),\n\n    /**\n     * Send new context request to the provider.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListConsumer.request({foo: 'bar'});\n     * const newProductList = await productListConsumer.untilChange();\n     * ```\n     */\n    request: requestContext.bind(null, contextId) as\n      OmitFirstParam<typeof requestContext<TRquest>>,\n  } as const),\n} as const;\n"]}

package/requestable-context-provider.d.ts

@@ -48,9 +48,11 @@ export declare const requestableContextProvider: {
         readonly getValue: () => TContext_1 | undefined;
         readonly setValue: (detail: TContext_1, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
         readonly expire: () => void;
+        readonly untilChange: () => Promise<TContext_1>;
     };
     readonly getValue: <T extends Stringifyable>(signalId: string) => T | undefined;
     readonly setValue: <T_1 extends Stringifyable>(signalId: string, detail: T_1, options?: Partial<import("./type.js").DispatchOptions>) => void;
     readonly expire: (signalId: string) => void;
+    readonly untilChange: <T_2 extends Stringifyable>(signalId: string) => Promise<T_2>;
 };
 //# sourceMappingURL=requestable-context-provider.d.ts.map

package/requestable-context-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestable-context-provider.d.ts","sourceRoot":"","sources":["src/requestable-context-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;OAQG;kGAC8E,MAAM;QAGrF;;;;;;;;;;;;WAYG;;;;;;;;;;CAIG,CAAC"}
+{"version":3,"file":"requestable-context-provider.d.ts","sourceRoot":"","sources":["src/requestable-context-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;OAQG;kGAC8E,MAAM;QAGrF;;;;;;;;;;;;WAYG;;;;;;;;;;;;CAIG,CAAC"}

package/type.d.ts

@@ -1,5 +1,5 @@
-import { MaybePromise, Stringifyable } from '@alwatr/type';
-export type DebounceType = 'No' | 'AnimationFrame' | 'Timeout';
+import type { MaybePromise, Stringifyable } from '@alwatr/type';
+export type DebounceType = 'No' | 'NextCycle' | 'AnimationFrame' | 'Timeout';
 /**
  * Subscribe options type.
  */
@@ -24,18 +24,20 @@ export interface SubscribeOptions {
      * Calling this listener (callback) with preview signal value (if dispatched before).
      * If Immediate, the listener will be called immediately without any debounce for preview signal.
      *
-     * @default `AnimationFrame`
+     * @default `NextCycle`
      */
-    receivePrevious: DebounceType | 'NextCycle';
+    receivePrevious: DebounceType;
 }
 /**
  * dispatchSignal options type
  */
 export interface DispatchOptions {
     /**
-     * If true, the dispatch will be send after animation frame debounce.
-     * If false, every signal is matter and count.
-     * tips: debounce work like throttle this means listeners call with last dispatch value.
+     * If 'AnimationFrame' or 'Timeout', the dispatch will be debounced (single dispatch for all changes).
+     *
+     * If 'No' or 'NextCycle', every signal is matter and count without debounced (every changes dispatched).
+     *
+     * tips: debounce work like throttle this means listeners call with latest dispatch value.
      *
      * @default `AnimationFrame`
      */
@@ -51,11 +53,13 @@ export interface ProviderOptions {
      *
      * @default `NextCycle`
      */
-    receivePrevious: DebounceType | 'NextCycle';
+    receivePrevious: DebounceType;
     /**
-     * If true, the dispatch will be send after animation frame debounce.
-     * If false, every signal is matter and count.
-     * tips: debounce true work like throttle this means listeners call with last dispatch value.
+     * If 'AnimationFrame' or 'Timeout', the dispatch will be debounced (single dispatch for all changes).
+     *
+     * If 'No' or 'NextCycle', every signal is matter and count without debounced (every changes dispatched).
+     *
+     * tips: debounce work like throttle this means listeners call with latest dispatch value.
      *
      * @default `AnimationFrame`
      */

package/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,eAAe,EAAE,YAAY,GAAG,WAAW,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,EAAE,YAAY,GAAG,WAAW,CAAC;IAE5C;;;;;;OAMG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,EAAE,OAAO,IAAI,CACjD,cAAc,EAAE,SAAS,KACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,aAAa,IAAI,YAAY,GAAG;IACnE;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI;IAClD;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,CAAC"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,eAAe,EAAE,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,EAAE,YAAY,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,EAAE,OAAO,IAAI,CACjD,cAAc,EAAE,SAAS,KACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,aAAa,IAAI,YAAY,GAAG;IACnE;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI;IAClD;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,CAAC"}

package/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"","sourcesContent":["import {MaybePromise, Stringifyable} from '@alwatr/type';\n\nexport type DebounceType = 'No' | 'AnimationFrame' | 'Timeout';\n\n/**\n * Subscribe options type.\n */\nexport interface SubscribeOptions {\n  /**\n   * If true, the listener will be called only once.\n   * @default false\n   */\n  once: boolean;\n\n  /**\n   * If true, the listener will be called before other.\n   * @default false\n   */\n  priority: boolean;\n\n  /**\n   * If true, the listener will be defined disabled by default.\n   *\n   * @default false\n   */\n  disabled: boolean;\n\n  /**\n   * Calling this listener (callback) with preview signal value (if dispatched before).\n   * If Immediate, the listener will be called immediately without any debounce for preview signal.\n   *\n   * @default `AnimationFrame`\n   */\n  receivePrevious: DebounceType | 'NextCycle';\n}\n\n/**\n * dispatchSignal options type\n */\nexport interface DispatchOptions {\n  /**\n   * If true, the dispatch will be send after animation frame debounce.\n   * If false, every signal is matter and count.\n   * tips: debounce work like throttle this means listeners call with last dispatch value.\n   *\n   * @default `AnimationFrame`\n   */\n  debounce: DebounceType;\n}\n\n/**\n * setSignalProvider options type.\n */\nexport interface ProviderOptions {\n  /**\n   * Calling signal provider (request signal callback) with preview signal value (if dispatched before).\n   * If Immediate, the listener will be called immediately without any debounce for preview signal.\n   *\n   * @default `NextCycle`\n   */\n  receivePrevious: DebounceType | 'NextCycle';\n\n  /**\n   * If true, the dispatch will be send after animation frame debounce.\n   * If false, every signal is matter and count.\n   * tips: debounce true work like throttle this means listeners call with last dispatch value.\n   *\n   * @default `AnimationFrame`\n   */\n  debounce: DebounceType;\n}\n\n/**\n * Subscribe callback function.\n */\nexport type ListenerFunction<T extends Stringifyable> = (detail: T) => void | Promise<void>;\n\n/**\n * Command/Context provider/handler function.\n */\nexport type ProviderFunction<TArgument, TReturn> = (\n  argumentObject: TArgument\n) => MaybePromise<TReturn>;\n\n/**\n * Listener spec.\n */\nexport type ListenerSpec = {\n  /**\n   * Unique listener id\n   */\n  id: number;\n\n  /**\n   * Signal id\n   */\n  signalId: string;\n}\n\n/**\n * Signal listeners object in storage.\n */\nexport type ListenerObject<T extends Stringifyable> = ListenerSpec & {\n  /**\n   * If true, the listener will be called only once and removed automatically after first call\n   */\n  once: boolean;\n\n  /**\n   * If true, the listener will be disabled.\n   */\n  disabled: boolean;\n\n  callback: ListenerFunction<T>;\n};\n\n/**\n * Signal object in storage.\n */\nexport type SignalObject<T extends Stringifyable> = {\n  /**\n   * Signal id for direct access.\n   */\n  id: string;\n\n  /**\n   * Last dispatched detail.\n   */\n  detail?: T;\n\n  /**\n   * If true, the signal is disabled.\n   */\n  disabled: boolean;\n\n  /**\n   * Dispatches debounced (delayed).\n   * Internal use case for debounce dispatch signal.\n   */\n  debounced: boolean;\n\n  /**\n   * Signal listeners list.\n   */\n  listenerList: Array<ListenerObject<T>>;\n};\n\n/**\n * Signal stack storage.\n */\nexport type SignalStorage = Record<string, SignalObject<Stringifyable> | undefined>;\n"]}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"","sourcesContent":["import type {MaybePromise, Stringifyable} from '@alwatr/type';\n\nexport type DebounceType = 'No' | 'NextCycle' | 'AnimationFrame' | 'Timeout';\n\n/**\n * Subscribe options type.\n */\nexport interface SubscribeOptions {\n  /**\n   * If true, the listener will be called only once.\n   * @default false\n   */\n  once: boolean;\n\n  /**\n   * If true, the listener will be called before other.\n   * @default false\n   */\n  priority: boolean;\n\n  /**\n   * If true, the listener will be defined disabled by default.\n   *\n   * @default false\n   */\n  disabled: boolean;\n\n  /**\n   * Calling this listener (callback) with preview signal value (if dispatched before).\n   * If Immediate, the listener will be called immediately without any debounce for preview signal.\n   *\n   * @default `NextCycle`\n   */\n  receivePrevious: DebounceType;\n}\n\n/**\n * dispatchSignal options type\n */\nexport interface DispatchOptions {\n  /**\n   * If 'AnimationFrame' or 'Timeout', the dispatch will be debounced (single dispatch for all changes).\n   *\n   * If 'No' or 'NextCycle', every signal is matter and count without debounced (every changes dispatched).\n   *\n   * tips: debounce work like throttle this means listeners call with latest dispatch value.\n   *\n   * @default `AnimationFrame`\n   */\n  debounce: DebounceType;\n}\n\n/**\n * setSignalProvider options type.\n */\nexport interface ProviderOptions {\n  /**\n   * Calling signal provider (request signal callback) with preview signal value (if dispatched before).\n   * If Immediate, the listener will be called immediately without any debounce for preview signal.\n   *\n   * @default `NextCycle`\n   */\n  receivePrevious: DebounceType;\n\n  /**\n   * If 'AnimationFrame' or 'Timeout', the dispatch will be debounced (single dispatch for all changes).\n   *\n   * If 'No' or 'NextCycle', every signal is matter and count without debounced (every changes dispatched).\n   *\n   * tips: debounce work like throttle this means listeners call with latest dispatch value.\n   *\n   * @default `AnimationFrame`\n   */\n  debounce: DebounceType;\n}\n\n/**\n * Subscribe callback function.\n */\nexport type ListenerFunction<T extends Stringifyable> = (detail: T) => void | Promise<void>;\n\n/**\n * Command/Context provider/handler function.\n */\nexport type ProviderFunction<TArgument, TReturn> = (\n  argumentObject: TArgument\n) => MaybePromise<TReturn>;\n\n/**\n * Listener spec.\n */\nexport type ListenerSpec = {\n  /**\n   * Unique listener id\n   */\n  id: number;\n\n  /**\n   * Signal id\n   */\n  signalId: string;\n}\n\n/**\n * Signal listeners object in storage.\n */\nexport type ListenerObject<T extends Stringifyable> = ListenerSpec & {\n  /**\n   * If true, the listener will be called only once and removed automatically after first call\n   */\n  once: boolean;\n\n  /**\n   * If true, the listener will be disabled.\n   */\n  disabled: boolean;\n\n  callback: ListenerFunction<T>;\n};\n\n/**\n * Signal object in storage.\n */\nexport type SignalObject<T extends Stringifyable> = {\n  /**\n   * Signal id for direct access.\n   */\n  id: string;\n\n  /**\n   * Last dispatched detail.\n   */\n  detail?: T;\n\n  /**\n   * If true, the signal is disabled.\n   */\n  disabled: boolean;\n\n  /**\n   * Dispatches debounced (delayed).\n   * Internal use case for debounce dispatch signal.\n   */\n  debounced: boolean;\n\n  /**\n   * Signal listeners list.\n   */\n  listenerList: Array<ListenerObject<T>>;\n};\n\n/**\n * Signal stack storage.\n */\nexport type SignalStorage = Record<string, SignalObject<Stringifyable> | undefined>;\n"]}