@alwatr/signal 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.31.0](https://github.com/AliMD/alwatr/compare/v0.30.0...v0.31.0) (2023-05-08)
+
+### Bug Fixes
+
+- new logger api ([9d83a7d](https://github.com/AliMD/alwatr/commit/9d83a7dc5c103bc3bb4282dacfd85fa998915300))
+- **signal:** dont receivePrevious when listener is disabled ([68ae207](https://github.com/AliMD/alwatr/commit/68ae207ce9ecf104922b24910d8dfcedb13acde7))
+- **signal:** requestableContextProvider.getValue ([0a7111d](https://github.com/AliMD/alwatr/commit/0a7111da7b8eb004566922dc9b35edfc02a55147))
+
+### Features
+
+- **signal:** new RequestableContext with state ([b8a8e55](https://github.com/AliMD/alwatr/commit/b8a8e550d3952863d85ba9d9d87513a668a9430d))
+
+# [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.
  *
@@ -101,7 +101,7 @@ export declare const untilNext: <T extends Stringifyable>(signalId: string) => P
  * setContextProvider('content-change', async (requestParam) => await fetchNewContent(requestParam));
  * ```
  */
-export declare const setContextProvider: <TContext extends Stringifyable, TRquest extends Stringifyable>(signalId: string, signalProvider: ProviderFunction<TRquest, void | TContext>, options?: Partial<ProviderOptions>) => void;
+export declare const setContextProvider: <TContext extends Stringifyable, TRquest extends Stringifyable = null>(signalId: string, signalProvider: ProviderFunction<TRquest, void | TContext>, options?: Partial<ProviderOptions>) => void;
 /**
  * Defines the command and dispatch returned value.
  *
@@ -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,mFACnB,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,9 @@ 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) => {
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, '_callListeners', { signalId: signal.id, signalDetail: detail });
     const removeList = [];
     for (const listener of signal.listenerList) {
         if (listener.disabled)
@@ -57,7 +53,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,
@@ -84,12 +80,12 @@ export const _callListeners = (signal) => {
  * ```
  */
 export const subscribe = (signalId, listenerCallback, options = {}) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     (_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 });
+    (_e = logger.logMethodArgs) === null || _e === void 0 ? void 0 : _e.call(logger, 'subscribe', { signalId, options });
     const signal = getSignalObject(signalId);
     const listener = {
         id: ++_lastListenerAutoId,
@@ -98,8 +94,8 @@ export const subscribe = (signalId, listenerCallback, options = {}) => {
         disabled: options.disabled,
         callback: listenerCallback,
     };
-    const callbackCall = signal.detail !== undefined && options.receivePrevious !== 'No';
-    if (callbackCall) {
+    const execCallback = signal.detail !== undefined && options.receivePrevious !== 'No' && options.disabled !== true;
+    if (execCallback) {
         // Run callback for old dispatch signal
         const callback = () => {
             try {
@@ -120,7 +116,7 @@ export const subscribe = (signalId, listenerCallback, options = {}) => {
         }
     }
     // if once then must remove listener after fist callback called! then why push it to listenerList?!
-    if (!(callbackCall && options.once)) {
+    if (!(execCallback && options.once)) {
         if (options.priority === true) {
             signal.listenerList.unshift(listener);
         }
@@ -145,7 +141,8 @@ export const subscribe = (signalId, listenerCallback, options = {}) => {
  * ```
  */
 export const unsubscribe = (listener) => {
-    logger.logMethodArgs('unsubscribe', listener);
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'unsubscribe', listener);
     const signal = getSignalObject(listener.signalId);
     const listenerIndex = signal.listenerList.findIndex((_listener) => _listener.id === listener.id);
     if (listenerIndex !== -1) {
@@ -162,7 +159,8 @@ export const unsubscribe = (listener) => {
  * ```
  */
 export const removeAllListeners = (signalId) => {
-    logger.logMethodArgs('removeAllListeners', signalId);
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'removeAllListeners', signalId);
     const signal = getSignalObject(signalId);
     if (signal.listenerList.length === 0)
         return;
@@ -181,24 +179,31 @@ export const removeAllListeners = (signalId) => {
  * ```
  */
 export const dispatch = (signalId, detail, options = {}) => {
-    var _a;
+    var _a, _b;
     (_a = options.debounce) !== null && _a !== void 0 ? _a : (options.debounce = 'AnimationFrame');
-    logger.logMethodArgs('dispatch', { signalId, detail, options });
+    (_b = logger.logMethodArgs) === null || _b === void 0 ? void 0 : _b.call(logger, 'dispatch', { signalId, detail, options });
     const signal = getSignalObject(signalId);
     // set detail before check signal.debounced for act like throttle (call listeners with last dispatch detail).
     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'
@@ -233,7 +238,8 @@ export const getDetail = (signalId) => {
  */
 export const untilNext = (signalId) => {
     return new Promise((resolve) => {
-        logger.logMethodArgs('untilNext', signalId);
+        var _a;
+        (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'untilNext', signalId);
         subscribe(signalId, resolve, {
             once: true,
             priority: true,
@@ -252,10 +258,10 @@ export const untilNext = (signalId) => {
  * ```
  */
 export const setContextProvider = (signalId, signalProvider, options = {}) => {
-    var _a, _b;
+    var _a, _b, _c;
     (_a = options.debounce) !== null && _a !== void 0 ? _a : (options.debounce = 'AnimationFrame');
     (_b = options.receivePrevious) !== null && _b !== void 0 ? _b : (options.receivePrevious = 'AnimationFrame');
-    logger.logMethodArgs('setContextProvider', { signalId, options });
+    (_c = logger.logMethodArgs) === null || _c === void 0 ? void 0 : _c.call(logger, 'setContextProvider', { signalId, options });
     const requestSignalId = 'request-' + signalId;
     removeAllListeners(requestSignalId);
     subscribe(requestSignalId, async (argumentObject) => {
@@ -284,12 +290,12 @@ export const setContextProvider = (signalId, signalProvider, options = {}) => {
  * ```
  */
 export const defineCommand = (signalId, signalProvider, options = {}) => {
-    var _a;
+    var _a, _b;
     (_a = options.debounce) !== null && _a !== void 0 ? _a : (options.debounce = 'AnimationFrame');
-    logger.logMethodArgs('defineCommand', { commandId: signalId, options });
+    (_b = logger.logMethodArgs) === null || _b === void 0 ? void 0 : _b.call(logger, '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);
@@ -311,8 +317,9 @@ export const defineCommand = (signalId, signalProvider, options = {}) => {
  * ```
  */
 export const requestContext = (contextId, requestParam, options = {}) => {
-    logger.logMethodArgs('requestContext', { contextId, requestParam });
-    return dispatch(contextId, requestParam, options);
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'requestContext', { contextId, requestParam });
+    return dispatch(`request-${contextId}`, requestParam, options);
 };
 /**
  * Dispatch request command signal with commandArgument as detail.
@@ -324,7 +331,8 @@ export const requestContext = (contextId, requestParam, options = {}) => {
  * ```
  */
 export const requestCommand = (commandId, commandArgument) => {
-    logger.logMethodArgs('requestCommand', { commandId, commandArgument });
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'requestCommand', { commandId, commandArgument });
     dispatch(`request-${commandId}`, commandArgument, { debounce: 'No' });
 };
 /**
@@ -339,14 +347,15 @@ export const requestCommand = (commandId, commandArgument) => {
  * ```
  */
 export const requestCommandWithResponse = async (commandId, commandArgument) => {
-    logger.logMethodArgs('requestCommand', { commandId, commandArgument });
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'requestCommand', { commandId, commandArgument });
     const _requestSignalId = `request-${commandId}`;
     const _callbackSignalId = `callback-${commandId}-${++_lastListenerAutoId}`;
     const untilCallback = untilNext(_callbackSignalId);
     dispatch(_requestSignalId, {
         ...commandArgument,
         _callbackSignalId,
-    }, { debounce: 'No' });
+    }, { debounce: 'NextCycle' });
     const response = await untilCallback;
     destroySignal(_callbackSignalId);
     return response;
@@ -363,7 +372,8 @@ export const requestCommandWithResponse = async (commandId, commandArgument) =>
  * ```
  */
 export const clearDetail = (signalId) => {
-    logger.logMethodArgs('expire', signalId);
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'expire', signalId);
     const signal = getSignalObject(signalId);
     delete signal.detail;
 };
@@ -379,7 +389,8 @@ export const clearDetail = (signalId) => {
  * ```
  */
 export const destroySignal = (signalId) => {
-    logger.logMethodArgs('destroySignal', signalId);
+    var _a;
+    (_a = logger.logMethodArgs) === null || _a === void 0 ? void 0 : _a.call(logger, 'destroySignal', signalId);
     const signal = _signalStorage[signalId];
     if (signal == null)
         return;

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":"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","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 execCallback = signal.detail !== undefined && options.receivePrevious !== 'No' && options.disabled !== true;\n  if (execCallback) {\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 (!(execCallback && 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 = null>(\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.31.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.31.0",
+    "@alwatr/type": "^0.31.0",
+    "@alwatr/util": "^0.31.0",
     "tslib": "^2.5.0"
   },
-  "gitHead": "801487f183f8afd8cba25e0fec5d508c0b4fe809"
+  "gitHead": "896e64b58eed6e9048e870557ecf399d42705612"
 }

package/requestable-context-consumer.d.ts

@@ -1,3 +1,4 @@
+import { RequestableContext } from './type.js';
 import type { Stringifyable } from '@alwatr/type';
 /**
  * Requestable context consumer interface.
@@ -10,7 +11,7 @@ export declare const requestableContextConsumer: {
      *
      * ```ts
      * requestableContextConsumer.request<RequestParamType>('product-list', {foo: 'bar'});
-     * const newProductList = await requestableContextConsumer.untilChange<ProductListType>('product-list');
+     * TODO: update me
      * ```
      */
     readonly request: <TRequest extends Stringifyable>(contextId: string, requestParam: TRequest, options?: Partial<import("./type.js").DispatchOptions>) => void;
@@ -23,7 +24,18 @@ export declare const requestableContextConsumer: {
      * const productListConsumer = requestableContextConsumer.bind<ProductListType>('product-list');
      * ```
      */
-    readonly bind: <TContext extends Stringifyable, TRquest extends Stringifyable>(contextId: string) => {
+    readonly bind: <TContextContent extends Stringifyable, TRquest extends Stringifyable = null>(contextId: string) => {
+        /**
+         * Get context value.
+         *
+         * Example:
+         *
+         * ```ts
+         * const currentProductList = productListConsumer.getValue();
+         * TODO: update me
+         * ```
+         */
+        readonly getValue: () => RequestableContext<TContextContent>;
         /**
          * Send new context request to the provider.
          *
@@ -31,14 +43,13 @@ export declare const requestableContextConsumer: {
          *
          * ```ts
          * productListConsumer.request({foo: 'bar'});
-         * const newProductList = await productListConsumer.untilChange();
+         * TODO: update me
          * ```
          */
         readonly request: (requestParam: TRquest, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
         readonly id: string;
-        readonly getValue: () => TContext | undefined;
-        readonly untilChange: () => Promise<TContext>;
-        readonly subscribe: (listenerCallback: import("./type.js").ListenerFunction<TContext>, options?: Partial<import("./type.js").SubscribeOptions> | undefined) => import("./type.js").ListenerSpec;
+        readonly untilChange: () => Promise<RequestableContext<TContextContent>>;
+        readonly subscribe: (listenerCallback: import("./type.js").ListenerFunction<RequestableContext<TContextContent>>, options?: Partial<import("./type.js").SubscribeOptions> | undefined) => import("./type.js").ListenerSpec;
         readonly unsubscribe: (listener: import("./type.js").ListenerSpec) => void;
     };
     readonly getValue: <T extends Stringifyable>(signalId: string) => T | undefined;

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":"AAEA,OAAO,EAAC,kBAAkB,EAAC,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;4GAC4F,MAAM;QAGnG;;;;;;;;;WASG;;QAIH;;;;;;;;;WASG;;;;;;;;;;;CAIG,CAAC"}

package/requestable-context-consumer.js

@@ -1,5 +1,5 @@
 import { contextConsumer } from './context-consumer.js';
-import { requestContext } from './core.js';
+import { getDetail, requestContext } from './core.js';
 /**
  * Requestable context consumer interface.
  */
@@ -12,7 +12,7 @@ export const requestableContextConsumer = {
      *
      * ```ts
      * requestableContextConsumer.request<RequestParamType>('product-list', {foo: 'bar'});
-     * const newProductList = await requestableContextConsumer.untilChange<ProductListType>('product-list');
+     * TODO: update me
      * ```
      */
     request: requestContext,
@@ -27,6 +27,17 @@ export const requestableContextConsumer = {
      */
     bind: (contextId) => ({
         ...contextConsumer.bind(contextId),
+        /**
+         * Get context value.
+         *
+         * Example:
+         *
+         * ```ts
+         * const currentProductList = productListConsumer.getValue();
+         * TODO: update me
+         * ```
+         */
+        getValue: () => { var _a; return (_a = getDetail(contextId)) !== null && _a !== void 0 ? _a : { state: 'initial' }; },
         /**
          * Send new context request to the provider.
          *
@@ -34,10 +45,10 @@ export const requestableContextConsumer = {
          *
          * ```ts
          * productListConsumer.request({foo: 'bar'});
-         * const newProductList = await productListConsumer.untilChange();
+         * TODO: update me
          * ```
          */
-        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,SAAS,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAKpD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,eAAe;IAElB;;;;;;;;;OASG;IACH,OAAO,EAAE,cAAc;IAEvB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAA8E,SAAiB,EAAE,EAAE,CAAA,CAAC;QACxG,GAAG,eAAe,CAAC,IAAI,CAAsC,SAAS,CAAC;QAEvE;;;;;;;;;WASG;QACH,QAAQ,EAAE,GAAwC,EAAE,WAClD,OAAA,MAAA,SAAS,CAAsC,SAAS,CAAC,mCAAI,EAAC,KAAK,EAAE,SAAS,EAAC,CAAA,EAAA;QAEjF;;;;;;;;;WASG;QACH,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACI;KACvC,CAAA;CACH,CAAC","sourcesContent":["import {contextConsumer} from './context-consumer.js';\nimport {getDetail, requestContext} from './core.js';\nimport {RequestableContext} from './type.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   * TODO: update me\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: <TContextContent extends Stringifyable, TRquest extends Stringifyable = null>(contextId: string) =>({\n    ...contextConsumer.bind<RequestableContext<TContextContent>>(contextId),\n\n    /**\n     * Get context value.\n     *\n     * Example:\n     *\n     * ```ts\n     * const currentProductList = productListConsumer.getValue();\n     * TODO: update me\n     * ```\n     */\n    getValue: (): RequestableContext<TContextContent> =>\n      getDetail<RequestableContext<TContextContent>>(contextId) ?? {state: 'initial'},\n\n    /**\n     * Send new context request to the provider.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListConsumer.request({foo: 'bar'});\n     * TODO: update me\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

@@ -1,3 +1,4 @@
+import { RequestableContext } from './type.js';
 import type { Stringifyable } from '@alwatr/type';
 /**
  * Requestable context provider interface.
@@ -19,7 +20,7 @@ export declare const requestableContextProvider: {
      * );
      * ```
      */
-    readonly setProvider: <TContext extends Stringifyable, TRquest extends Stringifyable>(signalId: string, signalProvider: import("./type.js").ProviderFunction<TRquest, void | TContext>, options?: Partial<import("./type.js").ProviderOptions>) => void;
+    readonly setProvider: <TContext extends Stringifyable, TRquest extends Stringifyable = null>(signalId: string, signalProvider: import("./type.js").ProviderFunction<TRquest, void | TContext>, options?: Partial<import("./type.js").ProviderOptions>) => void;
     /**
      * Bind this interface to special context.
      *
@@ -29,7 +30,18 @@ export declare const requestableContextProvider: {
      * const productListProvider = requestableContextProvider.bind<ProductListType>('product-list');
      * ```
      */
-    readonly bind: <TContext_1 extends Stringifyable, TRquest_1 extends Stringifyable>(contextId: string) => {
+    readonly bind: <TContextContent extends Stringifyable, TRquest_1 extends Stringifyable = null>(contextId: string) => {
+        /**
+         * Get context value.
+         *
+         * Example:
+         *
+         * ```ts
+         * const currentProductList = productListConsumer.getValue();
+         * TODO: update me
+         * ```
+         */
+        readonly getValue: () => RequestableContext<TContextContent>;
         /**
          * Defines the provider of the context signal that will be called when the context requested.
          *
@@ -43,14 +55,15 @@ export declare const requestableContextProvider: {
          * });
          * ```
          */
-        readonly setProvider: (signalProvider: import("./type.js").ProviderFunction<TRquest_1, void | TContext_1>, options?: Partial<import("./type.js").ProviderOptions> | undefined) => void;
+        readonly setProvider: (signalProvider: import("./type.js").ProviderFunction<TRquest_1, void | RequestableContext<TContextContent>>, options?: Partial<import("./type.js").ProviderOptions> | undefined) => void;
         readonly id: string;
-        readonly getValue: () => TContext_1 | undefined;
-        readonly setValue: (detail: TContext_1, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
+        readonly setValue: (detail: RequestableContext<TContextContent>, options?: Partial<import("./type.js").DispatchOptions> | undefined) => void;
         readonly expire: () => void;
+        readonly untilChange: () => Promise<RequestableContext<TContextContent>>;
     };
     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":"AAEA,OAAO,EAAC,kBAAkB,EAAC,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,0BAA0B;IAGrC;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;OAQG;8GAC4F,MAAM;QAGnG;;;;;;;;;WASG;;QAKH;;;;;;;;;;;;WAYG;;;;;;;;;;;CAIG,CAAC"}

package/requestable-context-provider.js

@@ -1,5 +1,5 @@
 import { contextProvider } from './context-provider.js';
-import { setContextProvider } from './core.js';
+import { getDetail, setContextProvider } from './core.js';
 /**
  * Requestable context provider interface.
  */
@@ -33,6 +33,17 @@ export const requestableContextProvider = {
      */
     bind: (contextId) => ({
         ...contextProvider.bind(contextId),
+        /**
+         * Get context value.
+         *
+         * Example:
+         *
+         * ```ts
+         * const currentProductList = productListConsumer.getValue();
+         * TODO: update me
+         * ```
+         */
+        getValue: () => { var _a; return (_a = getDetail(contextId)) !== null && _a !== void 0 ? _a : { state: 'initial' }; },
         /**
          * Defines the provider of the context signal that will be called when the context requested.
          *

package/requestable-context-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestable-context-provider.js","sourceRoot":"","sources":["src/requestable-context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,kBAAkB,EAAC,MAAM,WAAW,CAAC;AAI7C;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,eAAe;IAElB;;;;;;;;;;;;;;;OAeG;IACH,WAAW,EAAE,kBAAkB;IAE/B;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAgE,SAAiB,EAAE,EAAE,CAAA,CAAC;QAC1F,GAAG,eAAe,CAAC,IAAI,CAAW,SAAS,CAAC;QAE5C;;;;;;;;;;;;WAYG;QACH,WAAW,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACU;KACrD,CAAA;CACH,CAAC","sourcesContent":["import {contextProvider} from './context-provider.js';\nimport {setContextProvider} from './core.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Requestable context provider interface.\n */\nexport const requestableContextProvider = {\n  ...contextProvider,\n\n  /**\n   * Defines the provider of the context signal that will be called when the context requested.\n   *\n   * subscribe to request context signal.\n   *\n   * Example:\n   *\n   * ```ts\n   * requestableContextProvider.setProvider<ProductListType, RequestParamType>(\n   *   'product-list',\n   *   async (requestParam) => {\n   *     return await fetchNewProductList(requestParam)\n   *   },\n   * );\n   * ```\n   */\n  setProvider: setContextProvider,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListProvider = requestableContextProvider.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <TContext extends Stringifyable, TRquest extends Stringifyable>(contextId: string) =>({\n    ...contextProvider.bind<TContext>(contextId),\n\n    /**\n     * Defines the provider of the context signal that will be called when the context requested.\n     *\n     * subscribe to request context signal.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.setProvider(async (requestParam) => {\n     *   return await fetchNewProductList(requestParam)\n     * });\n     * ```\n     */\n    setProvider: setContextProvider.bind(null, contextId) as\n      OmitFirstParam<typeof setContextProvider<TContext, TRquest>>,\n  } as const),\n} as const;\n"]}
+{"version":3,"file":"requestable-context-provider.js","sourceRoot":"","sources":["src/requestable-context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAE,kBAAkB,EAAC,MAAM,WAAW,CAAC;AAKxD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,eAAe;IAElB;;;;;;;;;;;;;;;OAeG;IACH,WAAW,EAAE,kBAAkB;IAE/B;;;;;;;;OAQG;IACH,IAAI,EAAE,CAA8E,SAAiB,EAAE,EAAE,CAAA,CAAC;QACxG,GAAG,eAAe,CAAC,IAAI,CAAsC,SAAS,CAAC;QAEvE;;;;;;;;;WASG;QACH,QAAQ,EAAE,GAAwC,EAAE,WAClD,OAAA,MAAA,SAAS,CAAsC,SAAS,CAAC,mCAAI,EAAC,KAAK,EAAE,SAAS,EAAC,CAAA,EAAA;QAGjF;;;;;;;;;;;;WAYG;QACH,WAAW,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACqC;KAChF,CAAA;CACH,CAAC","sourcesContent":["import {contextProvider} from './context-provider.js';\nimport {getDetail, setContextProvider} from './core.js';\nimport {RequestableContext} from './type.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Requestable context provider interface.\n */\nexport const requestableContextProvider = {\n  ...contextProvider,\n\n  /**\n   * Defines the provider of the context signal that will be called when the context requested.\n   *\n   * subscribe to request context signal.\n   *\n   * Example:\n   *\n   * ```ts\n   * requestableContextProvider.setProvider<ProductListType, RequestParamType>(\n   *   'product-list',\n   *   async (requestParam) => {\n   *     return await fetchNewProductList(requestParam)\n   *   },\n   * );\n   * ```\n   */\n  setProvider: setContextProvider,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListProvider = requestableContextProvider.bind<ProductListType>('product-list');\n   * ```\n   */\n  bind: <TContextContent extends Stringifyable, TRquest extends Stringifyable = null>(contextId: string) =>({\n    ...contextProvider.bind<RequestableContext<TContextContent>>(contextId),\n\n    /**\n     * Get context value.\n     *\n     * Example:\n     *\n     * ```ts\n     * const currentProductList = productListConsumer.getValue();\n     * TODO: update me\n     * ```\n     */\n    getValue: (): RequestableContext<TContextContent> =>\n      getDetail<RequestableContext<TContextContent>>(contextId) ?? {state: 'initial'},\n\n\n    /**\n     * Defines the provider of the context signal that will be called when the context requested.\n     *\n     * subscribe to request context signal.\n     *\n     * Example:\n     *\n     * ```ts\n     * productListProvider.setProvider(async (requestParam) => {\n     *   return await fetchNewProductList(requestParam)\n     * });\n     * ```\n     */\n    setProvider: setContextProvider.bind(null, contextId) as\n      OmitFirstParam<typeof setContextProvider<RequestableContext<TContextContent>, TRquest>>,\n  } as const),\n} as const;\n"]}

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`
      */
@@ -126,4 +130,17 @@ export type SignalObject<T extends Stringifyable> = {
  * Signal stack storage.
  */
 export type SignalStorage = Record<string, SignalObject<Stringifyable> | undefined>;
+/**
+ * Requestable context value type.
+ */
+export type RequestableContext<T extends Stringifyable> = {
+    state: 'initial' | 'pending';
+    content?: never;
+} | {
+    state: 'error';
+    content?: T;
+} | {
+    state: 'complete' | 'reloading';
+    content: T;
+};
 //# sourceMappingURL=type.d.ts.map

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,CAAC,cAAc,EAAE,SAAS,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;AAExG;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;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;AAEpF;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,aAAa,IAClD;IACE,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,GACD;IACE,KAAK,EAAE,UAAU,GAAG,WAAW,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC;CACZ,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> = (argumentObject: TArgument) => 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\n/**\n * Requestable context value type.\n */\nexport type RequestableContext<T extends Stringifyable> =\n  | {\n      state: 'initial' | 'pending';\n      content?: never;\n    }\n  | {\n      state: 'error';\n      content?: T; // last data\n    }\n  | {\n      state: 'complete' | 'reloading';\n      content: T;\n    };\n"]}