@alwatr/signal 1.1.2 → 2.0.0

package/type.d.ts

@@ -1,146 +1,35 @@
-import type { MaybePromise, Stringifyable } from '@alwatr/type';
-export type DebounceType = 'No' | 'NextCycle' | 'AnimationFrame' | 'Timeout';
+import type { MaybePromise } from '@alwatr/type';
 /**
  * Subscribe options type.
  */
 export interface SubscribeOptions {
     /**
      * If true, the listener will be called only once.
-     * @default false
      */
-    once: boolean;
+    once?: true;
     /**
      * If true, the listener will be called before other.
-     * @default false
      */
-    priority: boolean;
+    priority?: true;
     /**
      * If true, the listener will be defined disabled by default.
-     *
-     * @default false
      */
-    disabled: boolean;
+    disabled?: true;
     /**
-     * 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 `NextCycle`
+     * If true, calls the listener (callback) with previous signal value (if dispatched before).
      */
-    receivePrevious: DebounceType;
+    receivePrevious?: boolean;
 }
-/**
- * dispatchSignal options type
- */
-export interface DispatchOptions {
-    /**
-     * 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`
-     */
-    debounce: DebounceType;
+export type ListenerCallback<T, D> = (this: T, detail: D) => MaybePromise<void>;
+export interface Observer<T, D> {
+    callback: ListenerCallback<T, D>;
+    options: SubscribeOptions;
 }
-/**
- * setSignalProvider options type.
- */
-export interface ProviderOptions {
-    /**
-     * Calling signal provider (request signal callback) with preview signal value (if dispatched before).
-     * If Immediate, the listener will be called immediately without any debounce for preview signal.
-     *
-     * @default `NextCycle`
-     */
-    receivePrevious: DebounceType;
-    /**
-     * 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`
-     */
-    debounce: DebounceType;
+export interface SubscribeResult {
+    unsubscribe: () => void;
 }
-/**
- * Subscribe callback function.
- */
-export type ListenerFunction<T extends Stringifyable> = (detail: T) => void | Promise<void>;
-/**
- * Command/Context provider/handler function.
- */
-export type ProviderFunction<TArgument, TReturn> = (argumentObject: TArgument) => MaybePromise<TReturn>;
-/**
- * Listener spec.
- */
-export interface ListenerSpec {
-    /**
-     * Unique listener id
-     */
-    id: number;
-    /**
-     * Signal id
-     */
-    signalId: string;
+export interface AlwatrObservableInterface<T> {
+    subscribe(listenerCallback: ListenerCallback<this, T>, options?: SubscribeOptions): SubscribeResult;
+    unsubscribe(listenerCallback: ListenerCallback<this, T>): void;
 }
-/**
- * Signal listeners object in storage.
- */
-export type ListenerObject<T extends Stringifyable> = ListenerSpec & {
-    /**
-     * If true, the listener will be called only once and removed automatically after first call
-     */
-    once: boolean;
-    /**
-     * If true, the listener will be disabled.
-     */
-    disabled: boolean;
-    callback: ListenerFunction<T>;
-};
-/**
- * Signal object in storage.
- */
-export interface SignalObject<T extends Stringifyable> {
-    /**
-     * Signal id for direct access.
-     */
-    id: string;
-    /**
-     * Last dispatched detail.
-     */
-    detail?: T;
-    /**
-     * If true, the signal is disabled.
-     */
-    disabled: boolean;
-    /**
-     * Dispatches debounced (delayed).
-     * Internal use case for debounce dispatch signal.
-     */
-    debounced: boolean;
-    /**
-     * Signal listeners list.
-     */
-    listenerList: ListenerObject<T>[];
-}
-/**
- * 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,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,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;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,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa;IACnD;;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,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;CACnC;AAED;;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"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAM3B;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,QAAQ,CAAC,CAAC,EAAE,CAAC;IAC5B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACpG,WAAW,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;CAChE"}

package/type.js.map

@@ -1 +1 @@
-{"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 interface 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 interface 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: 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"]}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["src/type.ts"],"names":[],"mappings":"","sourcesContent":["import type {MaybePromise} from '@alwatr/type';\n\n/**\n * Subscribe options type.\n */\nexport interface SubscribeOptions {\n  /**\n   * If true, the listener will be called only once.\n   */\n  once?: true;\n\n  /**\n   * If true, the listener will be called before other.\n   */\n  priority?: true;\n\n  /**\n   * If true, the listener will be defined disabled by default.\n   */\n  disabled?: true;\n\n  /**\n   * If true, calls the listener (callback) with previous signal value (if dispatched before).\n   */\n  receivePrevious?: boolean;\n\n  /**\n   * If defined, calls the listener (callback) with debounce.\n   */\n  // debounce?: 'AnimationFrame' | number;\n}\n\nexport type ListenerCallback<T, D> = (this: T, detail: D) => MaybePromise<void>;\n\nexport interface Observer<T, D> {\n  callback: ListenerCallback<T, D>;\n  options: SubscribeOptions;\n}\n\nexport interface SubscribeResult {\n  unsubscribe: () => void;\n}\n\nexport interface AlwatrObservableInterface<T> {\n  subscribe(listenerCallback: ListenerCallback<this, T>, options?: SubscribeOptions): SubscribeResult;\n  unsubscribe(listenerCallback: ListenerCallback<this, T>): void;\n}\n"]}

package/command-handler.d.ts

@@ -1,25 +0,0 @@
-/**
- * Command handler/define interface.
- */
-export declare const commandHandler: {
-    /**
-     * Defines the command and dispatch returned value.
-     *
-     * Subscribe commandFunction to request-command-signal and dispatch callback-signal with commandFunction return value.
-     *
-     * Example:
-     *
-     * ```ts
-     * commandHandler.define<TArgument, TReturn>(
-     *   'show-prompt',
-     *   async (argumentObject) => {
-     *      return await showPrompt(argumentObject);
-     *   },
-     * );
-     * ```
-     */
-    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">>) => import("./type.js").ListenerSpec;
-};
-//# sourceMappingURL=command-handler.d.ts.map

package/command-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["src/command-handler.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;;;;;;;;;;OAeG;;;;CAEK,CAAC"}

package/command-handler.js

@@ -1,24 +0,0 @@
-import { defineCommand } from './core.js';
-/**
- * Command handler/define interface.
- */
-export const commandHandler = {
-    /**
-     * Defines the command and dispatch returned value.
-     *
-     * Subscribe commandFunction to request-command-signal and dispatch callback-signal with commandFunction return value.
-     *
-     * Example:
-     *
-     * ```ts
-     * commandHandler.define<TArgument, TReturn>(
-     *   'show-prompt',
-     *   async (argumentObject) => {
-     *      return await showPrompt(argumentObject);
-     *   },
-     * );
-     * ```
-     */
-    define: defineCommand,
-};
-//# sourceMappingURL=command-handler.js.map

package/command-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["src/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,EAAE,aAAa;CACb,CAAC","sourcesContent":["import {defineCommand} from './core.js';\n\n/**\n * Command handler/define interface.\n */\nexport const commandHandler = {\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   * commandHandler.define<TArgument, TReturn>(\n   *   'show-prompt',\n   *   async (argumentObject) => {\n   *      return await showPrompt(argumentObject);\n   *   },\n   * );\n   * ```\n   */\n  define: defineCommand,\n} as const;\n"]}

package/command-trigger.d.ts

@@ -1,64 +0,0 @@
-import type { Stringifyable, StringifyableRecord } from '@alwatr/type';
-/**
- * Command trigger/request interface.
- */
-export declare const commandTrigger: {
-    /**
-     * Dispatch request command signal with commandArgument as detail.
-     *
-     * Example:
-     *
-     * ```ts
-     * commandTrigger.request<ArgumentType>('show-dialog', {foo: 'bar'});
-     * ```
-     */
-    readonly request: <TArgument extends StringifyableRecord>(commandId: string, commandArgument: TArgument) => void;
-    /**
-     * 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 commandTrigger.requestWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});
-     * ```
-     */
-    readonly requestWithResponse: <TArgument_1 extends StringifyableRecord, TReturn extends Stringifyable>(commandId: string, commandArgument: TArgument_1) => Promise<TReturn>;
-    /**
-     * Bind define command to special command.
-     *
-     * Example:
-     *
-     * ```ts
-     * const showDialog = commandTrigger.bind<ArgumentType, ReturnType>('show-dialog');
-     * ```
-     */
-    readonly bind: <TArgument_2 extends StringifyableRecord, TReturn_1 extends Stringifyable>(commandId: string) => {
-        /**
-         * Command signal Id.
-         */
-        id: string;
-        /**
-         * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.
-         *
-         * Example:
-         *
-         * ```ts
-         * showDialog.request({foo: 'bar'});
-         * ```
-         */
-        request: (commandArgument: TArgument_2) => void;
-        /**
-         * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.
-         *
-         * Example:
-         *
-         * ```ts
-         * const response = await showDialog.requestWithResponse({foo: 'bar'});
-         * ```
-         */
-        requestWithResponse: (commandArgument: TArgument_2) => Promise<TReturn_1>;
-    };
-};
-//# sourceMappingURL=command-trigger.d.ts.map

package/command-trigger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-trigger.d.ts","sourceRoot":"","sources":["src/command-trigger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,aAAa,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;;;OAQG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;OAQG;yGACqF,MAAM;QAC5F;;WAEG;;QAGH;;;;;;;;WAQG;;QAIH;;;;;;;;WAQG;;;CAIG,CAAC"}

package/command-trigger.js

@@ -1,64 +0,0 @@
-import { requestCommand, requestCommandWithResponse } from './core.js';
-/**
- * Command trigger/request interface.
- */
-export const commandTrigger = {
-    /**
-     * Dispatch request command signal with commandArgument as detail.
-     *
-     * Example:
-     *
-     * ```ts
-     * commandTrigger.request<ArgumentType>('show-dialog', {foo: 'bar'});
-     * ```
-     */
-    request: requestCommand,
-    /**
-     * 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 commandTrigger.requestWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});
-     * ```
-     */
-    requestWithResponse: requestCommandWithResponse,
-    /**
-     * Bind define command to special command.
-     *
-     * Example:
-     *
-     * ```ts
-     * const showDialog = commandTrigger.bind<ArgumentType, ReturnType>('show-dialog');
-     * ```
-     */
-    bind: (commandId) => ({
-        /**
-         * Command signal Id.
-         */
-        id: commandId,
-        /**
-         * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.
-         *
-         * Example:
-         *
-         * ```ts
-         * showDialog.request({foo: 'bar'});
-         * ```
-         */
-        request: requestCommand.bind(null, commandId),
-        /**
-         * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.
-         *
-         * Example:
-         *
-         * ```ts
-         * const response = await showDialog.requestWithResponse({foo: 'bar'});
-         * ```
-         */
-        requestWithResponse: requestCommandWithResponse.bind(null, commandId),
-    }),
-};
-//# sourceMappingURL=command-trigger.js.map

package/command-trigger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-trigger.js","sourceRoot":"","sources":["src/command-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,0BAA0B,EAAC,MAAM,WAAW,CAAC;AAIrE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;;;;;;OAQG;IACH,OAAO,EAAE,cAAc;IAEvB;;;;;;;;;;OAUG;IACH,mBAAmB,EAAE,0BAA0B;IAE/C;;;;;;;;OAQG;IACH,IAAI,EAAE,CAAuE,SAAiB,EAAE,EAAE,CAAA,CAAC;QACjG;;WAEG;QACH,EAAE,EAAE,SAAS;QAEb;;;;;;;;WAQG;QACH,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACM;QAElD;;;;;;;;WAQG;QACH,mBAAmB,EAAE,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACG;KACxE,CAAC;CACM,CAAC","sourcesContent":["import {requestCommand, requestCommandWithResponse} from './core.js';\n\nimport type {OmitFirstParam, Stringifyable, StringifyableRecord} from '@alwatr/type';\n\n/**\n * Command trigger/request interface.\n */\nexport const commandTrigger = {\n  /**\n   * Dispatch request command signal with commandArgument as detail.\n   *\n   * Example:\n   *\n   * ```ts\n   * commandTrigger.request<ArgumentType>('show-dialog', {foo: 'bar'});\n   * ```\n   */\n  request: requestCommand,\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 commandTrigger.requestWithResponse<ArgumentType, ReturnType>('show-dialog', {foo: 'bar'});\n   * ```\n   */\n  requestWithResponse: requestCommandWithResponse,\n\n  /**\n   * Bind define command to special command.\n   *\n   * Example:\n   *\n   * ```ts\n   * const showDialog = commandTrigger.bind<ArgumentType, ReturnType>('show-dialog');\n   * ```\n   */\n  bind: <TArgument extends StringifyableRecord, TReturn extends Stringifyable>(commandId: string) =>({\n    /**\n     * Command signal Id.\n     */\n    id: commandId,\n\n    /**\n     * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.\n     *\n     * Example:\n     *\n     * ```ts\n     * showDialog.request({foo: 'bar'});\n     * ```\n     */\n    request: requestCommand.bind(null, commandId) as unknown as\n      OmitFirstParam<typeof requestCommand<TArgument>>,\n\n    /**\n     * Dispatch request command signal with commandArgument as detail and return untilNext of callback signal.\n     *\n     * Example:\n     *\n     * ```ts\n     * const response = await showDialog.requestWithResponse({foo: 'bar'});\n     * ```\n     */\n    requestWithResponse: requestCommandWithResponse.bind(null, commandId) as unknown as\n      OmitFirstParam<typeof requestCommandWithResponse<TArgument, TReturn>>,\n  }),\n} as const;\n"]}

package/context-consumer.d.ts

@@ -1,124 +0,0 @@
-import type { Stringifyable } from '@alwatr/type';
-/**
- * Context consumer interface.
- */
-export declare const contextConsumer: {
-    /**
-     * Get context value.
-     *
-     * Return undefined if context not set before or expired.
-     *
-     * Example:
-     *
-     * ```ts
-     * const currentProductList = contextConsumer.getValue<ProductListType>('product-list');
-     * if (currentProductList === undefined) {
-     *   // productList not set before or expired.
-     * }
-     * ```
-     */
-    readonly getValue: <T extends Stringifyable>(signalId: string) => T | undefined;
-    /**
-     * Waits until the context value changes.
-     *
-     * Example:
-     *
-     * ```ts
-     * const newProductList = await contextConsumer.untilChange<ProductListType>('product-list');
-     * ```
-     */
-    readonly untilChange: <T_1 extends Stringifyable>(signalId: string) => Promise<T_1>;
-    /**
-     * Subscribe to context changes, work like addEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {
-     *   console.log(productList);
-     * });
-     * // ...
-     * contextConsumer.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 from context changes, work like removeEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {
-     *   console.log(productList);
-     * });
-     * // ...
-     * contextConsumer.unsubscribe(listener);
-     * ```
-     */
-    readonly unsubscribe: (listener: import("./type.js").ListenerSpec) => void;
-    /**
-     * Bind this interface to special context.
-     *
-     * Example:
-     *
-     * ```ts
-     * const productListConsumer = contextConsumer.bind<ProductListType>('product-list');
-     * ```
-     */
-    readonly bind: <T_3 extends Stringifyable>(contextId: string) => {
-        /**
-         * Context signal Id.
-         */
-        readonly id: string;
-        /**
-         * Get context value.
-         *
-         * Return undefined if context not set before or expired.
-         *
-         * Example:
-         *
-         * ```ts
-         * const currentProductList = productListConsumer.getValue();
-         * if (currentProductList === undefined) {
-         *   // productList not set before or expired.
-         * }
-         * ```
-         */
-        readonly getValue: () => T_3 | undefined;
-        /**
-         * Waits until the context value changes.
-         *
-         * Example:
-         *
-         * ```ts
-         * const newProductList = await productListConsumer.untilChange();
-         * ```
-         */
-        readonly untilChange: () => Promise<T_3>;
-        /**
-         * Subscribe to context changes, work like addEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = productListConsumer.subscribe((productList) => console.log(productList));
-         * // ...
-         * productListConsumer.unsubscribe(listener);
-         * ```
-         */
-        readonly subscribe: (listenerCallback: import("./type.js").ListenerFunction<T_3>, options?: Partial<import("./type.js").SubscribeOptions> | undefined) => import("./type.js").ListenerSpec;
-        /**
-         * Unsubscribe from context changes, work like removeEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = productListConsumer.subscribe((productList) => console.log(productList));
-         * // ...
-         * productListConsumer.unsubscribe(listener);
-         * ```
-         */
-        readonly unsubscribe: (listener: import("./type.js").ListenerSpec) => void;
-    };
-};
-//# sourceMappingURL=context-consumer.d.ts.map

package/context-consumer.d.ts.map

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

package/context-consumer.js

@@ -1,124 +0,0 @@
-import { getDetail, subscribe, unsubscribe, untilNext } from './core.js';
-/**
- * Context consumer interface.
- */
-export const contextConsumer = {
-    /**
-     * Get context value.
-     *
-     * Return undefined if context not set before or expired.
-     *
-     * Example:
-     *
-     * ```ts
-     * const currentProductList = contextConsumer.getValue<ProductListType>('product-list');
-     * if (currentProductList === undefined) {
-     *   // productList not set before or expired.
-     * }
-     * ```
-     */
-    getValue: getDetail,
-    /**
-     * Waits until the context value changes.
-     *
-     * Example:
-     *
-     * ```ts
-     * const newProductList = await contextConsumer.untilChange<ProductListType>('product-list');
-     * ```
-     */
-    untilChange: untilNext,
-    /**
-     * Subscribe to context changes, work like addEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {
-     *   console.log(productList);
-     * });
-     * // ...
-     * contextConsumer.unsubscribe(listener);
-     * ```
-     */
-    subscribe: subscribe,
-    /**
-     * Unsubscribe from context changes, work like removeEventListener.
-     *
-     * Example:
-     *
-     * ```ts
-     * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {
-     *   console.log(productList);
-     * });
-     * // ...
-     * contextConsumer.unsubscribe(listener);
-     * ```
-     */
-    unsubscribe: unsubscribe,
-    /**
-     * Bind this interface to special context.
-     *
-     * Example:
-     *
-     * ```ts
-     * const productListConsumer = contextConsumer.bind<ProductListType>('product-list');
-     * ```
-     */
-    bind: (contextId) => ({
-        /**
-         * Context signal Id.
-         */
-        id: contextId,
-        /**
-         * Get context value.
-         *
-         * Return undefined if context not set before or expired.
-         *
-         * Example:
-         *
-         * ```ts
-         * const currentProductList = productListConsumer.getValue();
-         * if (currentProductList === undefined) {
-         *   // productList not set before or expired.
-         * }
-         * ```
-         */
-        getValue: getDetail.bind(null, contextId),
-        /**
-         * Waits until the context value changes.
-         *
-         * Example:
-         *
-         * ```ts
-         * const newProductList = await productListConsumer.untilChange();
-         * ```
-         */
-        untilChange: untilNext.bind(null, contextId),
-        /**
-         * Subscribe to context changes, work like addEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = productListConsumer.subscribe((productList) => console.log(productList));
-         * // ...
-         * productListConsumer.unsubscribe(listener);
-         * ```
-         */
-        subscribe: subscribe.bind(null, contextId),
-        /**
-         * Unsubscribe from context changes, work like removeEventListener.
-         *
-         * Example:
-         *
-         * ```ts
-         * const listener = productListConsumer.subscribe((productList) => console.log(productList));
-         * // ...
-         * productListConsumer.unsubscribe(listener);
-         * ```
-         */
-        unsubscribe: unsubscribe,
-    }),
-};
-//# sourceMappingURL=context-consumer.js.map

package/context-consumer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-consumer.js","sourceRoot":"","sources":["src/context-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,WAAW,CAAC;AAIvE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;;;;OAaG;IACH,QAAQ,EAAE,SAAS;IAEnB;;;;;;;;OAQG;IACH,WAAW,EAAE,SAAS;IAEtB;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,SAAS;IAEpB;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,WAAW;IAExB;;;;;;;;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;;;;;;;;WAQG;QACH,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAwC;QAEnF;;;;;;;;;;WAUG;QACH,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CACJ;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 * Context consumer interface.\n */\nexport const contextConsumer = {\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 = contextConsumer.getValue<ProductListType>('product-list');\n   * if (currentProductList === undefined) {\n   *   // productList not set before or expired.\n   * }\n   * ```\n   */\n  getValue: getDetail,\n\n  /**\n   * Waits until the context value changes.\n   *\n   * Example:\n   *\n   * ```ts\n   * const newProductList = await contextConsumer.untilChange<ProductListType>('product-list');\n   * ```\n   */\n  untilChange: untilNext,\n\n  /**\n   * Subscribe to context changes, work like addEventListener.\n   *\n   * Example:\n   *\n   * ```ts\n   * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {\n   *   console.log(productList);\n   * });\n   * // ...\n   * contextConsumer.unsubscribe(listener);\n   * ```\n   */\n  subscribe: subscribe,\n\n  /**\n   * Unsubscribe from context changes, work like removeEventListener.\n   *\n   * Example:\n   *\n   * ```ts\n   * const listener = contextConsumer.subscribe<ProductListType>('product-list', (productList) => {\n   *   console.log(productList);\n   * });\n   * // ...\n   * contextConsumer.unsubscribe(listener);\n   * ```\n   */\n  unsubscribe: unsubscribe,\n\n  /**\n   * Bind this interface to special context.\n   *\n   * Example:\n   *\n   * ```ts\n   * const productListConsumer = contextConsumer.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 = productListConsumer.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     * Waits until the context value changes.\n     *\n     * Example:\n     *\n     * ```ts\n     * const newProductList = await productListConsumer.untilChange();\n     * ```\n     */\n    untilChange: untilNext.bind(null, contextId) as OmitFirstParam<typeof untilNext<T>>,\n\n    /**\n     * Subscribe to context changes, work like addEventListener.\n     *\n     * Example:\n     *\n     * ```ts\n     * const listener = productListConsumer.subscribe((productList) => console.log(productList));\n     * // ...\n     * productListConsumer.unsubscribe(listener);\n     * ```\n     */\n    subscribe: subscribe.bind(null, contextId) as unknown as\n      OmitFirstParam<typeof subscribe<T>>,\n\n    /**\n     * Unsubscribe from context changes, work like removeEventListener.\n     *\n     * Example:\n     *\n     * ```ts\n     * const listener = productListConsumer.subscribe((productList) => console.log(productList));\n     * // ...\n     * productListConsumer.unsubscribe(listener);\n     * ```\n     */\n    unsubscribe: unsubscribe,\n  } as const),\n} as const;\n"]}