feat(signal): new requestable context provider interface

core/signal/src/requestable-context-provider.ts

@@ -0,0 +1,58 @@
+import {Stringifyable, OmitFirstParam} from '@alwatr/type';
+
+import {contextProvider} from './context-provider.js';
+import {signalManager} from './signal-manager.js';
+
+/**
+ * Requestable context provider interface.
+ */
+export const requestableContextProvider = {
+  ...contextProvider,
+
+  /**
+   * Defines the provider of the context signal that will be called when the context requested.
+   *
+   * subscribe to request context signal.
+   *
+   * Example:
+   *
+   * ```ts
+   * requestableContextProvider.setProvider<ProductListType, RequestParamType>(
+   *   'product-list',
+   *   async (requestParam) => {
+   *     return await fetchNewProductList(requestParam)
+   *   },
+   * );
+   * ```
+   */
+  setProvider: signalManager.setContextProvider,
+
+  /**
+   * Bind this interface to special context.
+   *
+   * Example:
+   *
+   * ```ts
+   * const productListProvider = requestableContextProvider.bind<ProductListType>('product-list');
+   * ```
+   */
+  bind: <TContext extends Stringifyable, TRquest extends Stringifyable>(contextId: string) =>({
+    ...contextProvider.bind<TContext>(contextId),
+
+    /**
+     * Defines the provider of the context signal that will be called when the context requested.
+     *
+     * subscribe to request context signal.
+     *
+     * Example:
+     *
+     * ```ts
+     * productListProvider.setProvider(async (requestParam) => {
+     *   return await fetchNewProductList(requestParam)
+     * });
+     * ```
+     */
+    setProvider: signalManager.setContextProvider.bind(null, contextId) as
+      OmitFirstParam<typeof signalManager.setContextProvider<TContext, TRquest>>,
+  } as const),
+} as const;

core/signal/src/signal-manager.ts

@@ -297,22 +297,22 @@ export const signalManager = {
    * signalManager.setContextProvider('content-change', async (requestParam) => await fetchNewContent(requestParam));
    * ```
    */
-  setContextProvider: <TArgument extends Stringifyable, TReturn extends Stringifyable>(
+  setContextProvider: <TContext extends Stringifyable, TRquest extends Stringifyable>(
     signalId: string,
-    signalProvider: ProviderFunction<TArgument, TReturn | void>,
+    signalProvider: ProviderFunction<TRquest, TContext | void>,
     options: Partial<ProviderOptions> = {},
   ): void => {
     options.debounce ??= 'AnimationFrame';
     options.receivePrevious ??= 'AnimationFrame';
     signalManager._logger.logMethodArgs('setContextProvider', {signalId, options});
     const requestSignalId = 'request-' + signalId;
     signalManager.removeAllListeners(requestSignalId);
-    signalManager.subscribe<TArgument>(
+    signalManager.subscribe<TRquest>(
         requestSignalId,
         async (argumentObject): Promise<void> => {
           const signalDetail = await signalProvider(argumentObject);
           if (signalDetail !== undefined) {
-            signalManager.dispatch<TReturn>(signalId, signalDetail, {debounce: options.debounce});
+            signalManager.dispatch<TContext>(signalId, signalDetail, {debounce: options.debounce});
           }
         },
         {