@alwatr/signal 1.1.2 → 2.0.1

package/core.js

@@ -1,388 +0,0 @@
-import { createLogger, globalAlwatr } from '@alwatr/logger';
-import { requestAnimationFrame } from '@alwatr/util';
-globalAlwatr.registeredList.push({
-    name: '@alwatr/signal',
-    version: _ALWATR_VERSION_,
-});
-/**
- * Listener `id`
- */
-let _lastListenerAutoId = 0;
-const debounceTimeout = 5;
-/**
- * Signal stack database.
- */
-const _signalStorage = {};
-export const logger = createLogger('alwatr/signal');
-/**
- * Get signal object by id, If not available, it will create a new signal with default options.
- *
- * Don't use it directly.
- *
- * Example:
- *
- * ```ts
- * const signal = getSignalObject<ContentType>('content-change');
- * signal.disabled = true;
- * ```
- */
-export const getSignalObject = (id) => {
-    let signal = _signalStorage[id];
-    if (signal == null) {
-        signal = _signalStorage[id] = {
-            id,
-            disabled: false,
-            debounced: false,
-            listenerList: [],
-        };
-    }
-    return signal;
-};
-/**
- * Call all listeners callback of special signal.
- *
- * Used inside dispatch, Don't use it directly.
- */
-export const _callListeners = (signal, detail) => {
-    logger.logMethodArgs?.('_callListeners', { signalId: signal.id, signalDetail: detail });
-    const removeList = [];
-    for (const listener of signal.listenerList) {
-        if (listener.disabled)
-            continue;
-        if (listener.once)
-            removeList.push(listener);
-        try {
-            const ret = listener.callback(detail);
-            if (ret instanceof Promise) {
-                ret.catch((err) => logger.error('_callListeners', 'call_listener_failed', err, {
-                    signalId: signal.id,
-                }));
-            }
-        }
-        catch (err) {
-            logger.error('_callListeners', 'call_listener_failed', err, {
-                signalId: signal.id,
-            });
-        }
-    }
-    removeList.forEach((listener) => unsubscribe(listener));
-};
-/**
- * Subscribe new signal listener to a signal, work like addEventListener.
- *
- * Example:
- *
- * ```ts
- * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));
- * // ...
- * unsubscribe(listener);
- * ```
- */
-export const subscribe = (signalId, listenerCallback, options = {}) => {
-    options.once ?? (options.once = false);
-    options.disabled ?? (options.disabled = false);
-    options.receivePrevious ?? (options.receivePrevious = 'NextCycle');
-    options.priority ?? (options.priority = false);
-    logger.logMethodArgs?.('subscribe', { signalId, options });
-    const signal = getSignalObject(signalId);
-    const listener = {
-        id: ++_lastListenerAutoId,
-        signalId: signal.id,
-        once: options.once,
-        disabled: options.disabled,
-        callback: listenerCallback,
-    };
-    const execCallback = signal.detail !== undefined && options.receivePrevious !== 'No' && options.disabled !== true;
-    if (execCallback) {
-        // Run callback for old dispatch signal
-        const callback = () => {
-            try {
-                if (signal.detail !== undefined)
-                    listenerCallback(signal.detail);
-            }
-            catch (err) {
-                logger.error('subscribe', 'call_signal_callback_failed', err, {
-                    signalId: signal.id,
-                });
-            }
-        };
-        if (options.receivePrevious === 'AnimationFrame') {
-            requestAnimationFrame(callback);
-        }
-        else {
-            setTimeout(callback, options.receivePrevious === 'NextCycle' ? 0 : debounceTimeout);
-        }
-    }
-    // if once then must remove listener after fist callback called! then why push it to listenerList?!
-    if (!(execCallback && options.once)) {
-        if (options.priority === true) {
-            signal.listenerList.unshift(listener);
-        }
-        else {
-            signal.listenerList.push(listener);
-        }
-    }
-    return {
-        id: listener.id,
-        signalId: listener.signalId,
-    };
-};
-/**
- * Unsubscribe listener from signal, work like removeEventListener.
- *
- * Example:
- *
- * ```ts
- * const listener = subscribe<ContentType>('content-change', (content) => console.log(content));
- * // ...
- * unsubscribe(listener);
- * ```
- */
-export const unsubscribe = (listener) => {
-    logger.logMethodArgs?.('unsubscribe', listener);
-    const signal = getSignalObject(listener.signalId);
-    const listenerIndex = signal.listenerList.findIndex((_listener) => _listener.id === listener.id);
-    if (listenerIndex !== -1) {
-        void signal.listenerList.splice(listenerIndex, 1);
-    }
-};
-/**
- * Unsubscribe all listener from a signal, clear all listeners.
- *
- * Example:
- *
- * ```ts
- * removeAllListeners('content-change');
- * ```
- */
-export const removeAllListeners = (signalId) => {
-    logger.logMethodArgs?.('removeAllListeners', signalId);
-    const signal = getSignalObject(signalId);
-    if (signal.listenerList.length === 0)
-        return;
-    signal.listenerList.length = 0;
-    signal.listenerList = [];
-};
-/**
- * Dispatch (send) signal to all listeners.
- *
- * Signal detail changed immediately without any debounce.
- *
- * Example:
- *
- * ```ts
- * dispatch<ContentType>('content-change', newContent);
- * ```
- */
-export const dispatch = (signalId, detail, options = {}) => {
-    options.debounce ?? (options.debounce = 'AnimationFrame');
-    logger.logMethodArgs?.('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.
-    if (options.debounce === 'No') {
-        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, signal.detail ?? detail);
-        signal.debounced = false;
-    };
-    options.debounce === 'AnimationFrame'
-        ? requestAnimationFrame(callListeners)
-        : setTimeout(callListeners, debounceTimeout);
-};
-/**
- * Get current signal detail/value.
- *
- * Return undefined if signal not dispatched before or expired.
- *
- * Example:
- *
- * ```ts
- * const currentContent = getDetail<ContentType>('content-change');
- * if (currentContent === undefined) {
- *   // signal not dispatched yet
- * }
- * ```
- */
-export const getDetail = (signalId) => {
-    return getSignalObject(signalId).detail;
-};
-/**
- * Get the detail/value of the next received signal.
- *
- * Example:
- *
- * ```ts
- * const newContent = await untilNext<ContentType>('content-change');
- * ```
- */
-export const untilNext = (signalId) => {
-    return new Promise((resolve) => {
-        logger.logMethodArgs?.('untilNext', signalId);
-        subscribe(signalId, resolve, {
-            once: true,
-            priority: true,
-            receivePrevious: 'No',
-        });
-    });
-};
-/**
- * Defines the provider of the context signal that will be called when the context requested.
- * Subscribe to `request-signalId`.
- *
- * Example:
- *
- * ```ts
- * setContextProvider('content-change', async (requestParam) => await fetchNewContent(requestParam));
- * ```
- */
-export const setContextProvider = (signalId, 
-// eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-signalProvider, options = {}) => {
-    options.debounce ?? (options.debounce = 'AnimationFrame');
-    options.receivePrevious ?? (options.receivePrevious = 'AnimationFrame');
-    logger.logMethodArgs?.('setContextProvider', { signalId, options });
-    const requestSignalId = 'request-' + signalId;
-    removeAllListeners(requestSignalId);
-    subscribe(requestSignalId, async (argumentObject) => {
-        const signalDetail = await signalProvider(argumentObject);
-        if (signalDetail !== undefined) {
-            dispatch(signalId, signalDetail, { debounce: options.debounce });
-        }
-    }, {
-        receivePrevious: options.receivePrevious,
-    });
-};
-/**
- * Defines the command and dispatch returned value.
- *
- * Subscribe commandFunction to request-command-signal and dispatch callback-signal with commandFunction return value.
- *
- * Example:
- *
- * ```ts
- * defineCommand<TArgument, TReturn>(
- *   'show-prompt',
- *   async (argumentObject) => {
- *      return await showPrompt(argumentObject);
- *   },
- * );
- * ```
- */
-export const defineCommand = (signalId, signalProvider, options = {}) => {
-    options.debounce ?? (options.debounce = 'AnimationFrame');
-    logger.logMethodArgs?.('defineCommand', { commandId: signalId, options });
-    const requestSignalId = 'request-' + signalId;
-    removeAllListeners(requestSignalId);
-    return subscribe(requestSignalId, async (argumentObject) => {
-        clearDetail(requestSignalId); // clean argumentObject from memory
-        if (argumentObject._callbackSignalId == null) {
-            signalProvider(argumentObject);
-        }
-        else {
-            // prettier-ignore
-            dispatch(argumentObject._callbackSignalId, await signalProvider(argumentObject), { debounce: options.debounce });
-        }
-    }, { receivePrevious: 'NextCycle' });
-};
-/**
- * Dispatch request context signal with requestParam as detail.
- *
- * Example:
- *
- * ```ts
- * requestContext<RequestParamType>('content-change', {foo: 'bar'});
- * const newContent = await untilNext<ContentType>('content-change');
- * ```
- */
-export const requestContext = (contextId, requestParam, options = {}) => {
-    logger.logMethodArgs?.('requestContext', { contextId, requestParam });
-    return dispatch(`request-${contextId}`, requestParam, options);
-};
-/**
- * Dispatch request command signal with commandArgument as detail.
- *
- * Example:
- *
- * ```ts
- * requestCommand<ArgumentType>('show-dialog', {foo: 'bar'});
- * ```
- */
-export const requestCommand = (commandId, commandArgument) => {
-    logger.logMethodArgs?.('requestCommand', { commandId, commandArgument });
-    dispatch(`request-${commandId}`, commandArgument, { debounce: 'No' });
-};
-/**
- * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.
- *
- * Request command and wait for answer.
- *
- * Example:
- *
- * ```ts
- * const response = await requestCommandWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});
- * ```
- */
-export const requestCommandWithResponse = async (commandId, commandArgument) => {
-    logger.logMethodArgs?.('requestCommand', { commandId, commandArgument });
-    const _requestSignalId = `request-${commandId}`;
-    const _callbackSignalId = `callback-${commandId}-${++_lastListenerAutoId}`;
-    const untilCallback = untilNext(_callbackSignalId);
-    dispatch(_requestSignalId, {
-        ...commandArgument,
-        _callbackSignalId,
-    }, { debounce: 'NextCycle' });
-    const response = await untilCallback;
-    destroySignal(_callbackSignalId);
-    return response;
-};
-/**
- * Clear current signal detail without dispatch new signal.
- *
- * new subscriber options.receivePrevious not work until new signal
- *
- * Example:
- *
- * ```ts
- * clearDetail('product-list');
- * ```
- */
-export const clearDetail = (signalId) => {
-    logger.logMethodArgs?.('expire', signalId);
-    const signal = getSignalObject(signalId);
-    delete signal.detail;
-};
-/**
- * Delete signal object with detail and listeners and options.
- *
- * new subscriber options.receivePrevious not work until new signal
- *
- * Example:
- *
- * ```ts
- * destroySignal('product-list');
- * ```
- */
-export const destroySignal = (signalId) => {
-    logger.logMethodArgs?.('destroySignal', signalId);
-    const signal = _signalStorage[signalId];
-    if (signal == null)
-        return;
-    signal.listenerList.length = 0;
-    delete _signalStorage[signalId];
-};
-//# sourceMappingURL=core.js.map

package/core.js.map

@@ -1 +0,0 @@
-{"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: 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  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\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/event-listener.d.ts

@@ -1,120 +0,0 @@
-import type { Stringifyable } from '@alwatr/type';
-/**
- * Event signal listener/subscriber interface.
- */
-export declare const eventListener: {
-    /**
-     * Get last event dispatched detail.
-     *
-     * Return undefined if signal not dispatched before or expired.
-     *
-     * Example:
-     *
-     * ```ts
-     * const currentSize = eventTrigger.getLastDetail<ResizeType>('window-resize');
-     * if (currentSize === undefined) {
-     *   // event-signal not dispatched yet
-     * }
-     * ```
-     */
-    readonly getLastDetail: <T extends Stringifyable>(signalId: string) => T | undefined;
-    /**
-     * Wait until new event.
-     *
-     * Example:
-     *
-     * ```ts
-     * const newSize = await eventTrigger.untilNext<ResizeType>('window-resize');
-     * ```
-     */
-    readonly untilNext: <T_1 extends Stringifyable>(signalId: string) => Promise<T_1>;
-    /**
-     * Subscribe new listener to an event, work like addEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));
-     * // ...
-     * eventTrigger.unsubscribe(listener);
-     * ```
-     */
-    readonly subscribe: <T_2 extends Stringifyable>(signalId: string, listenerCallback: import("./type.js").ListenerFunction<T_2>, options?: Partial<import("./type.js").SubscribeOptions>) => import("./type.js").ListenerSpec;
-    /**
-     * Unsubscribe listener from event, work like removeEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));
-     * // ...
-     * eventTrigger.unsubscribe(listener);
-     * ```
-     */
-    readonly unsubscribe: (listener: import("./type.js").ListenerSpec) => void;
-    /**
-     * Bind this interface to special event.
-     *
-     * Example:
-     *
-     * ```ts
-     * const resizeEvent = eventTrigger.bind<ResizeType>('window-resize');
-     * ```
-     */
-    readonly bind: <T_3 extends Stringifyable>(eventId: string) => {
-        /**
-         * Event signal Id.
-         */
-        readonly id: string;
-        /**
-         * Get last event dispatched detail.
-         *
-         * Return undefined if signal not dispatched before or expired.
-         *
-         * Example:
-         *
-         * ```ts
-         * const currentSize = resizeEvent.getLastDetail();
-         * if (currentSize === undefined) {
-         *   // signal not dispatched yet
-         * }
-         * ```
-         */
-        readonly getLastDetail: () => T_3 | undefined;
-        /**
-         * Wait until new event.
-         *
-         * Example:
-         *
-         * ```ts
-         * const newSize = await resizeEvent.untilNext();
-         * ```
-         */
-        readonly untilNext: () => Promise<T_3>;
-        /**
-         * Subscribe new listener to an event, work like addEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = resizeEvent.subscribe((size) => console.log(size));
-         * // ...
-         * resizeEvent.unsubscribe(listener);
-         * ```
-         */
-        readonly subscribe: (listenerCallback: import("./type.js").ListenerFunction<T_3>, options?: Partial<import("./type.js").SubscribeOptions> | undefined) => import("./type.js").ListenerSpec;
-        /**
-         * Unsubscribe listener from event, work like removeEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = resizeEvent.subscribe((size) => console.log(size));
-         * // ...
-         * resizeEvent.unsubscribe(listener);
-         * ```
-         */
-        readonly unsubscribe: (listener: import("./type.js").ListenerSpec) => void;
-    };
-};
-//# sourceMappingURL=event-listener.d.ts.map

package/event-listener.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-listener.d.ts","sourceRoot":"","sources":["src/event-listener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAiB,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;;;;;;;;;;;;OAaG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;OAQG;wDACsC,MAAM;QAC7C;;WAEG;;QAGH;;;;;;;;;;;;;WAaG;;QAGH;;;;;;;;WAQG;;QAGH;;;;;;;;;;WAUG;;QAIH;;;;;;;;;;WAUG;;;CAGG,CAAC"}

package/event-listener.js

@@ -1,120 +0,0 @@
-import { getDetail, subscribe, unsubscribe, untilNext } from './core.js';
-/**
- * Event signal listener/subscriber interface.
- */
-export const eventListener = {
-    /**
-     * Get last event dispatched detail.
-     *
-     * Return undefined if signal not dispatched before or expired.
-     *
-     * Example:
-     *
-     * ```ts
-     * const currentSize = eventTrigger.getLastDetail<ResizeType>('window-resize');
-     * if (currentSize === undefined) {
-     *   // event-signal not dispatched yet
-     * }
-     * ```
-     */
-    getLastDetail: getDetail,
-    /**
-     * Wait until new event.
-     *
-     * Example:
-     *
-     * ```ts
-     * const newSize = await eventTrigger.untilNext<ResizeType>('window-resize');
-     * ```
-     */
-    untilNext: untilNext,
-    /**
-     * Subscribe new listener to an event, work like addEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));
-     * // ...
-     * eventTrigger.unsubscribe(listener);
-     * ```
-     */
-    subscribe: subscribe,
-    /**
-     * Unsubscribe listener from event, work like removeEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));
-     * // ...
-     * eventTrigger.unsubscribe(listener);
-     * ```
-     */
-    unsubscribe: unsubscribe,
-    /**
-     * Bind this interface to special event.
-     *
-     * Example:
-     *
-     * ```ts
-     * const resizeEvent = eventTrigger.bind<ResizeType>('window-resize');
-     * ```
-     */
-    bind: (eventId) => ({
-        /**
-         * Event signal Id.
-         */
-        id: eventId,
-        /**
-         * Get last event dispatched detail.
-         *
-         * Return undefined if signal not dispatched before or expired.
-         *
-         * Example:
-         *
-         * ```ts
-         * const currentSize = resizeEvent.getLastDetail();
-         * if (currentSize === undefined) {
-         *   // signal not dispatched yet
-         * }
-         * ```
-         */
-        getLastDetail: getDetail.bind(null, eventId),
-        /**
-         * Wait until new event.
-         *
-         * Example:
-         *
-         * ```ts
-         * const newSize = await resizeEvent.untilNext();
-         * ```
-         */
-        untilNext: untilNext.bind(null, eventId),
-        /**
-         * Subscribe new listener to an event, work like addEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = resizeEvent.subscribe((size) => console.log(size));
-         * // ...
-         * resizeEvent.unsubscribe(listener);
-         * ```
-         */
-        subscribe: subscribe.bind(null, eventId),
-        /**
-         * Unsubscribe listener from event, work like removeEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = resizeEvent.subscribe((size) => console.log(size));
-         * // ...
-         * resizeEvent.unsubscribe(listener);
-         * ```
-         */
-        unsubscribe: unsubscribe,
-    }),
-};
-//# sourceMappingURL=event-listener.js.map

package/event-listener.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-listener.js","sourceRoot":"","sources":["src/event-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAIvE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;;;;;;;;;;;OAaG;IACH,aAAa,EAAE,SAAS;IAExB;;;;;;;;OAQG;IACH,SAAS,EAAE,SAAS;IAEpB;;;;;;;;;;OAUG;IACH,SAAS,EAAE,SAAS;IAEpB;;;;;;;;;;OAUG;IACH,WAAW,EAAE,WAAW;IAExB;;;;;;;;OAQG;IACH,IAAI,EAAE,CAA0B,OAAe,EAAE,EAAE,CAAC,CAAC;QACnD;;WAEG;QACH,EAAE,EAAE,OAAO;QAEX;;;;;;;;;;;;;WAaG;QACH,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAwC;QAEnF;;;;;;;;WAQG;QACH,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAwC;QAE/E;;;;;;;;;;WAUG;QACH,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CACF;QAErC;;;;;;;;;;WAUG;QACH,WAAW,EAAE,WAAW;KACf,CAAA;CACH,CAAC","sourcesContent":["import {getDetail, subscribe, unsubscribe, untilNext} from './core.js';\n\nimport type {Stringifyable, OmitFirstParam} from '@alwatr/type';\n\n/**\n * Event signal listener/subscriber interface.\n */\nexport const eventListener = {\n  /**\n   * Get last event dispatched detail.\n   *\n   * Return undefined if signal not dispatched before or expired.\n   *\n   * Example:\n   *\n   * ```ts\n   * const currentSize = eventTrigger.getLastDetail<ResizeType>('window-resize');\n   * if (currentSize === undefined) {\n   *   // event-signal not dispatched yet\n   * }\n   * ```\n   */\n  getLastDetail: getDetail,\n\n  /**\n   * Wait until new event.\n   *\n   * Example:\n   *\n   * ```ts\n   * const newSize = await eventTrigger.untilNext<ResizeType>('window-resize');\n   * ```\n   */\n  untilNext: untilNext,\n\n  /**\n   * Subscribe new listener to an event, work like addEventListener.\n   *\n   * Example:\n   *\n   * ```ts\n   * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));\n   * // ...\n   * eventTrigger.unsubscribe(listener);\n   * ```\n   */\n  subscribe: subscribe,\n\n  /**\n   * Unsubscribe listener from event, work like removeEventListener.\n   *\n   * Example:\n   *\n   * ```ts\n   * const listener = eventTrigger.subscribe<ResizeType>('window-resize', (size) => console.log(size));\n   * // ...\n   * eventTrigger.unsubscribe(listener);\n   * ```\n   */\n  unsubscribe: unsubscribe,\n\n  /**\n   * Bind this interface to special event.\n   *\n   * Example:\n   *\n   * ```ts\n   * const resizeEvent = eventTrigger.bind<ResizeType>('window-resize');\n   * ```\n   */\n  bind: <T extends Stringifyable>(eventId: string) => ({\n    /**\n     * Event signal Id.\n     */\n    id: eventId,\n\n    /**\n     * Get last event dispatched detail.\n     *\n     * Return undefined if signal not dispatched before or expired.\n     *\n     * Example:\n     *\n     * ```ts\n     * const currentSize = resizeEvent.getLastDetail();\n     * if (currentSize === undefined) {\n     *   // signal not dispatched yet\n     * }\n     * ```\n     */\n    getLastDetail: getDetail.bind(null, eventId) as OmitFirstParam<typeof getDetail<T>>,\n\n    /**\n     * Wait until new event.\n     *\n     * Example:\n     *\n     * ```ts\n     * const newSize = await resizeEvent.untilNext();\n     * ```\n     */\n    untilNext: untilNext.bind(null, eventId) as OmitFirstParam<typeof untilNext<T>>,\n\n    /**\n     * Subscribe new listener to an event, work like addEventListener.\n     *\n     * Example:\n     *\n     * ```ts\n     * const listener = resizeEvent.subscribe((size) => console.log(size));\n     * // ...\n     * resizeEvent.unsubscribe(listener);\n     * ```\n     */\n    subscribe: subscribe.bind(null, eventId) as unknown as\n      OmitFirstParam<typeof subscribe<T>>,\n\n    /**\n     * Unsubscribe listener from event, work like removeEventListener.\n     *\n     * Example:\n     *\n     * ```ts\n     * const listener = resizeEvent.subscribe((size) => console.log(size));\n     * // ...\n     * resizeEvent.unsubscribe(listener);\n     * ```\n     */\n    unsubscribe: unsubscribe,\n  } as const),\n} as const;\n"]}