@alwatr/signal 2.0.5 → 3.0.0

package/README.md

@@ -1,5 +1,72 @@
-# Alwatr Signal - `@alwatr/signal`
+# @alwatr/signal
 
-Elegant powerful event system for handle global signals and states written in tiny TypeScript module.
+A simple and efficient TypeScript library for event-driven communication using signals.
 
-Every signal has own value and can be used as a advance **state management** like redux and recoil without the complexities and unnecessary facilities of those libraries.
+## Features
+
+* **Lightweight and focused:**  Provides a streamlined implementation of the signal pattern for event handling.
+* **TypeScript Support:**  Written in TypeScript with full type definitions for improved code quality and developer experience.
+* **Easy to use:**  Intuitive API for emitting and subscribing to events with strongly-typed messages.
+* **Asynchronous Support:**  Handle asynchronous events with Promise-based `untilNewNotify` method.
+* **Built-in Logging:**  Integrated logging for debugging and monitoring.
+
+## Installation
+
+```bash
+npm install @alwatr/signal
+```
+
+## Usage
+
+```typescript
+import {AlwatrSignal} from '@alwatr/signal';
+
+// Create a new signal
+const mySignal = new AlwatrSignal<{message: string}>({name: 'my-signal'});
+
+// Subscribe to the signal
+const subscription = mySignal.subscribe((message) => {
+  console.log('Received message:', message);
+});
+
+// Emit an event
+mySignal.notify({message: 'Hello, world!'});
+
+// Wait for the next event asynchronously
+const nextMessage = await mySignal.untilNewNotify();
+console.log('Next message:', nextMessage);
+
+// Unsubscribe when done
+subscription.unsubscribe();
+```
+
+## API
+
+### `AlwatrSignal`
+
+* **`constructor(config: {name: string; loggerPrefix?: string})`:** Creates a new `AlwatrSignal` instance.
+  * `config.name`: The name of the signal (used for logging).
+  * `config.loggerPrefix`: Optional prefix for log messages.
+
+* **`subscribe(listenerCallback: ListenerCallback<this, T>, options: SubscribeOptions = {}): SubscribeResult`:**  (Inherited from `AlwatrObservable`) Subscribes to the signal.
+  * `listenerCallback`: The function to be called when an event is emitted.
+  * `options`:
+    * `once`: If `true`, the listener will be automatically unsubscribed after the first event.
+    * `priority`: If `true`, the listener will be executed before other listeners.
+    * `receivePrevious`: If `true`, the listener will be immediately called with the last emitted event (if available).
+    * `disabled`: If `true`, the listener will not be executed.
+
+* **`unsubscribe(listenerCallback: ListenerCallback<this, T>)`:**  (Inherited from `AlwatrObservable`) Unsubscribes a listener from the signal.
+
+* **`notify(message: T)`:** Emits an event to all subscribers.
+  * `message`: The data to be sent to the subscribers.
+
+* **`untilNewNotify()`:** Returns a Promise that resolves with the next emitted event.
+
+## Contributing
+
+Contributions are welcome! Please read the contributing guidelines before submitting a pull request.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+export declare const logger: import("@alwatr/logger").AlwatrLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM,uCAAuD,CAAC"}

package/dist/main.cjs

@@ -0,0 +1,3 @@
+/* @alwatr/signal v3.0.0 */
+"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var g=(e,r)=>{for(var o in r)l(e,o,{get:r[o],enumerable:!0})},d=(e,r,o,p)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of b(r))!f.call(e,t)&&t!==o&&l(e,t,{get:()=>r[t],enumerable:!(p=u(r,t))||p.enumerable});return e};var w=e=>d(l({},"__esModule",{value:!0}),e);var v={};g(v,{AlwatrSignal:()=>s,AlwatrTrigger:()=>a});module.exports=w(v);var n=require("@alwatr/logger"),i=(0,n.definePackage)("@alwatr/signal","3.0.0");var m=require("@alwatr/observable");i.logModule?.("trigger");var a=class extends m.AlwatrObservable{constructor(r){r.loggerPrefix??(r.loggerPrefix="signal"),super(r)}notify(){this.notify_({})}async untilTriggered(){await super.untilNewNotify_()}};var y=require("@alwatr/observable");i.logModule?.("signal");var s=class extends y.AlwatrObservable{constructor(r){r.loggerPrefix??(r.loggerPrefix="signal"),super(r)}notify(r){this.notify_(r)}untilNewNotify(){return super.untilNewNotify_()}};0&&(module.exports={AlwatrSignal,AlwatrTrigger});
+//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/main.ts", "../src/logger.ts", "../src/trigger.ts", "../src/signal.ts"],
+  "sourcesContent": ["export * from './trigger.js';\nexport * from './signal.js';\n", "import {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport const logger = definePackage('@alwatr/signal', __package_version__);\n", "import {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport {logger} from './logger.js';\n\nlogger.logModule?.('trigger');\n\n/**\n * Alwatr event signal without any message (no event detail).\n */\nexport class AlwatrTrigger extends AlwatrObservable {\n  constructor(config: AlwatrObservableConfig) {\n    config.loggerPrefix ??= 'signal';\n    super(config);\n  }\n\n  /**\n   * Dispatch an event to all listeners.\n   */\n  notify(): void {\n    this.notify_({});\n  }\n\n  /**\n   * Wait until next event signal.\n   */\n  async untilTriggered(): Promise<void> {\n    await super.untilNewNotify_();\n  }\n}\n", "import {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport {logger} from './logger.js';\n\nimport type {Dictionary} from '@alwatr/type-helper';\n\nlogger.logModule?.('signal');\n\n/**\n * Alwatr event signal with special message (event detail).\n */\nexport class AlwatrSignal<T extends Dictionary = Dictionary> extends AlwatrObservable<T> {\n  constructor(config: AlwatrObservableConfig) {\n    config.loggerPrefix ??= 'signal';\n    super(config);\n  }\n\n  /**\n   * Dispatch an event to all listeners.\n   */\n  notify(message: T): void {\n    this.notify_(message);\n  }\n\n  /**\n   * Wait until next event.\n   */\n  untilNewNotify(): Promise<T> {\n    return super.untilNewNotify_();\n  }\n}\n"],
+  "mappings": ";yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,kBAAAC,IAAA,eAAAC,EAAAJ,GCAA,IAAAK,EAA4B,0BAIfC,KAAS,iBAAc,iBAAkB,OAAmB,ECJzE,IAAAC,EAA4D,8BAI5DC,EAAO,YAAY,SAAS,EAKrB,IAAMC,EAAN,cAA4B,kBAAiB,CAClD,YAAYC,EAAgC,CAC1CA,EAAO,eAAPA,EAAO,aAAiB,UACxB,MAAMA,CAAM,CACd,CAKA,QAAe,CACb,KAAK,QAAQ,CAAC,CAAC,CACjB,CAKA,MAAM,gBAAgC,CACpC,MAAM,MAAM,gBAAgB,CAC9B,CACF,EC5BA,IAAAC,EAA4D,8BAM5DC,EAAO,YAAY,QAAQ,EAKpB,IAAMC,EAAN,cAA8D,kBAAoB,CACvF,YAAYC,EAAgC,CAC1CA,EAAO,eAAPA,EAAO,aAAiB,UACxB,MAAMA,CAAM,CACd,CAKA,OAAOC,EAAkB,CACvB,KAAK,QAAQA,CAAO,CACtB,CAKA,gBAA6B,CAC3B,OAAO,MAAM,gBAAgB,CAC/B,CACF",
+  "names": ["main_exports", "__export", "AlwatrSignal", "AlwatrTrigger", "__toCommonJS", "import_logger", "logger", "import_observable", "logger", "AlwatrTrigger", "config", "import_observable", "logger", "AlwatrSignal", "config", "message"]
+}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+export * from './trigger.js';
+export * from './signal.js';
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/main.mjs

@@ -0,0 +1,3 @@
+/* @alwatr/signal v3.0.0 */
+import{definePackage as l}from"@alwatr/logger";var e=l("@alwatr/signal","3.0.0");import{AlwatrObservable as a}from"@alwatr/observable";e.logModule?.("trigger");var t=class extends a{constructor(r){r.loggerPrefix??(r.loggerPrefix="signal"),super(r)}notify(){this.notify_({})}async untilTriggered(){await super.untilNewNotify_()}};import{AlwatrObservable as s}from"@alwatr/observable";e.logModule?.("signal");var o=class extends s{constructor(r){r.loggerPrefix??(r.loggerPrefix="signal"),super(r)}notify(r){this.notify_(r)}untilNewNotify(){return super.untilNewNotify_()}};export{o as AlwatrSignal,t as AlwatrTrigger};
+//# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/logger.ts", "../src/trigger.ts", "../src/signal.ts"],
+  "sourcesContent": ["import {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport const logger = definePackage('@alwatr/signal', __package_version__);\n", "import {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport {logger} from './logger.js';\n\nlogger.logModule?.('trigger');\n\n/**\n * Alwatr event signal without any message (no event detail).\n */\nexport class AlwatrTrigger extends AlwatrObservable {\n  constructor(config: AlwatrObservableConfig) {\n    config.loggerPrefix ??= 'signal';\n    super(config);\n  }\n\n  /**\n   * Dispatch an event to all listeners.\n   */\n  notify(): void {\n    this.notify_({});\n  }\n\n  /**\n   * Wait until next event signal.\n   */\n  async untilTriggered(): Promise<void> {\n    await super.untilNewNotify_();\n  }\n}\n", "import {AlwatrObservable, type AlwatrObservableConfig} from '@alwatr/observable';\n\nimport {logger} from './logger.js';\n\nimport type {Dictionary} from '@alwatr/type-helper';\n\nlogger.logModule?.('signal');\n\n/**\n * Alwatr event signal with special message (event detail).\n */\nexport class AlwatrSignal<T extends Dictionary = Dictionary> extends AlwatrObservable<T> {\n  constructor(config: AlwatrObservableConfig) {\n    config.loggerPrefix ??= 'signal';\n    super(config);\n  }\n\n  /**\n   * Dispatch an event to all listeners.\n   */\n  notify(message: T): void {\n    this.notify_(message);\n  }\n\n  /**\n   * Wait until next event.\n   */\n  untilNewNotify(): Promise<T> {\n    return super.untilNewNotify_();\n  }\n}\n"],
+  "mappings": ";AAAA,OAAQ,iBAAAA,MAAoB,iBAIrB,IAAMC,EAASD,EAAc,iBAAkB,OAAmB,ECJzE,OAAQ,oBAAAE,MAAoD,qBAI5DC,EAAO,YAAY,SAAS,EAKrB,IAAMC,EAAN,cAA4BF,CAAiB,CAClD,YAAYG,EAAgC,CAC1CA,EAAO,eAAPA,EAAO,aAAiB,UACxB,MAAMA,CAAM,CACd,CAKA,QAAe,CACb,KAAK,QAAQ,CAAC,CAAC,CACjB,CAKA,MAAM,gBAAgC,CACpC,MAAM,MAAM,gBAAgB,CAC9B,CACF,EC5BA,OAAQ,oBAAAC,MAAoD,qBAM5DC,EAAO,YAAY,QAAQ,EAKpB,IAAMC,EAAN,cAA8DF,CAAoB,CACvF,YAAYG,EAAgC,CAC1CA,EAAO,eAAPA,EAAO,aAAiB,UACxB,MAAMA,CAAM,CACd,CAKA,OAAOC,EAAkB,CACvB,KAAK,QAAQA,CAAO,CACtB,CAKA,gBAA6B,CAC3B,OAAO,MAAM,gBAAgB,CAC/B,CACF",
+  "names": ["definePackage", "logger", "AlwatrObservable", "logger", "AlwatrTrigger", "config", "AlwatrObservable", "logger", "AlwatrSignal", "config", "message"]
+}

package/dist/signal.d.ts

@@ -0,0 +1,17 @@
+import { AlwatrObservable, type AlwatrObservableConfig } from '@alwatr/observable';
+import type { Dictionary } from '@alwatr/type-helper';
+/**
+ * Alwatr event signal with special message (event detail).
+ */
+export declare class AlwatrSignal<T extends Dictionary = Dictionary> extends AlwatrObservable<T> {
+    constructor(config: AlwatrObservableConfig);
+    /**
+     * Dispatch an event to all listeners.
+     */
+    notify(message: T): void;
+    /**
+     * Wait until next event.
+     */
+    untilNewNotify(): Promise<T>;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,KAAK,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAIjF,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAIpD;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;gBAC1E,MAAM,EAAE,sBAAsB;IAK1C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;IAIxB;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC;CAG7B"}

package/dist/trigger.d.ts

@@ -0,0 +1,16 @@
+import { AlwatrObservable, type AlwatrObservableConfig } from '@alwatr/observable';
+/**
+ * Alwatr event signal without any message (no event detail).
+ */
+export declare class AlwatrTrigger extends AlwatrObservable {
+    constructor(config: AlwatrObservableConfig);
+    /**
+     * Dispatch an event to all listeners.
+     */
+    notify(): void;
+    /**
+     * Wait until next event signal.
+     */
+    untilTriggered(): Promise<void>;
+}
+//# sourceMappingURL=trigger.d.ts.map

package/dist/trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../src/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,KAAK,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAMjF;;GAEG;AACH,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,MAAM,EAAE,sBAAsB;IAK1C;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}

package/package.json

@@ -1,41 +1,72 @@
 {
   "name": "@alwatr/signal",
-  "version": "2.0.5",
-  "description": "Elegant powerful event system for handle global signals and states written in tiny TypeScript module.",
+  "version": "3.0.0",
+  "description": "A simple and efficient TypeScript library for event-driven communication using signals.",
+  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "keywords": [
     "signal",
+    "observable",
     "typescript",
     "esm",
     "alwatr"
   ],
-  "main": "index.js",
   "type": "module",
-  "types": "index.d.ts",
-  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com> (https://ali.mihandoost.com)",
+  "main": "./dist/main.cjs",
+  "module": "./dist/main.mjs",
+  "types": "./dist/main.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/main.mjs",
+      "require": "./dist/main.cjs"
+    }
+  },
   "license": "MIT",
   "files": [
-    "**/*.{d.ts.map,d.ts,js.map,js,html,md}"
+    "**/*.{js,mjs,cjs,map,d.ts,html,md}",
+    "!demo/**/*"
   ],
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Alwatr/signal",
+    "url": "https://github.com/Alwatr/flux",
     "directory": "packages/signal"
   },
-  "homepage": "https://github.com/Alwatr/signal/tree/next/packages/signal#readme",
+  "homepage": "https://github.com/Alwatr/flux/tree/next/packages/signal#readme",
   "bugs": {
-    "url": "https://github.com/Alwatr/signal/issues"
+    "url": "https://github.com/Alwatr/flux/issues"
+  },
+  "prettier": "@alwatr/prettier-config",
+  "scripts": {
+    "b": "yarn run build",
+    "t": "yarn run test",
+    "w": "yarn run watch",
+    "c": "yarn run clean",
+    "cb": "yarn run clean && yarn run build",
+    "d": "yarn run build:es && yarn node --enable-source-maps --trace-warnings",
+    "build": "yarn run build:ts & yarn run build:es",
+    "build:es": "nano-build --preset=module",
+    "build:ts": "tsc --build",
+    "test": "NODE_OPTIONS=\"$NODE_OPTIONS --enable-source-maps --experimental-vm-modules\" jest",
+    "watch": "yarn run watch:ts & yarn run watch:es",
+    "watch:es": "yarn run build:es --watch",
+    "watch:ts": "yarn run build:ts --watch --preserveWatchOutput",
+    "clean": "rm -rfv dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@alwatr/logger": "^2.4.1",
-    "@alwatr/type": "^1.2.4",
-    "@alwatr/util": "^1.4.1",
-    "tslib": "^2.6.2"
+    "@alwatr/logger": "^3.2.13",
+    "@alwatr/observable": "^3.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.10.5"
+    "@alwatr/nano-build": "^1.3.9",
+    "@alwatr/prettier-config": "^1.0.4",
+    "@alwatr/tsconfig-base": "^1.2.0",
+    "@alwatr/type-helper": "^1.2.6",
+    "@types/node": "^22.5.5",
+    "jest": "^29.7.0",
+    "typescript": "^5.6.2"
   },
-  "gitHead": "bb15a99985f6643ab3435db3cec31ba39cc9c616"
+  "gitHead": "6c8830345d35da730c386adb047ca2cdcb3c36f0"
 }

package/context.d.ts

@@ -1,31 +0,0 @@
-import { AlwatrObservable } from './observable.js';
-/**
- * Alwatr context signal.
- */
-export declare class AlwatrContextSignal<T> extends AlwatrObservable<T> {
-    constructor(config: {
-        name: string;
-        loggerPrefix?: string;
-    });
-    /**
-     * Get context value.
-     *
-     * Return undefined if context not set before or expired.
-     */
-    getValue(): T | undefined;
-    /**
-     * Set context value and notify all subscribers.
-     */
-    setValue(value: T): void;
-    /**
-     * Clear current context value without notify subscribers.
-     *
-     * `receivePrevious` in new subscribers not work until new context changes.
-     */
-    expire(): void;
-    /**
-     * Get the value of the next context changes.
-     */
-    untilChange(): Promise<T>;
-}
-//# sourceMappingURL=context.d.ts.map

package/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;gBACjD,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAC;IAKzD;;;;OAIG;IACH,QAAQ,IAAI,CAAC,GAAG,SAAS;IAIzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKxB;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC;CAG1B"}

package/context.js

@@ -1,40 +0,0 @@
-import { AlwatrObservable } from './observable.js';
-/**
- * Alwatr context signal.
- */
-export class AlwatrContextSignal extends AlwatrObservable {
-    constructor(config) {
-        config.loggerPrefix ?? (config.loggerPrefix = 'context-signal');
-        super(config);
-    }
-    /**
-     * Get context value.
-     *
-     * Return undefined if context not set before or expired.
-     */
-    getValue() {
-        return super._getData();
-    }
-    /**
-     * Set context value and notify all subscribers.
-     */
-    setValue(value) {
-        this._logger.logMethodArgs?.('setValue', { value });
-        super._notify(value);
-    }
-    /**
-     * Clear current context value without notify subscribers.
-     *
-     * `receivePrevious` in new subscribers not work until new context changes.
-     */
-    expire() {
-        super._clear();
-    }
-    /**
-     * Get the value of the next context changes.
-     */
-    untilChange() {
-        return super._untilNewNotify();
-    }
-}
-//# sourceMappingURL=context.js.map

package/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,mBAAuB,SAAQ,gBAAmB;IAC7D,YAAY,MAA6C;QACvD,MAAM,CAAC,YAAY,KAAnB,MAAM,CAAC,YAAY,GAAK,gBAAgB,EAAC;QACzC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAQ;QACf,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;QAClD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,KAAK,CAAC,MAAM,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,eAAe,EAAE,CAAC;IACjC,CAAC;CACF","sourcesContent":["import {AlwatrObservable} from './observable.js';\n\n/**\n * Alwatr context signal.\n */\nexport class AlwatrContextSignal<T> extends AlwatrObservable<T> {\n  constructor(config: {name: string; loggerPrefix?: string}) {\n    config.loggerPrefix ??= 'context-signal';\n    super(config);\n  }\n\n  /**\n   * Get context value.\n   *\n   * Return undefined if context not set before or expired.\n   */\n  getValue(): T | undefined {\n    return super._getData();\n  }\n\n  /**\n   * Set context value and notify all subscribers.\n   */\n  setValue(value: T): void {\n    this._logger.logMethodArgs?.('setValue', {value});\n    super._notify(value);\n  }\n\n  /**\n   * Clear current context value without notify subscribers.\n   *\n   * `receivePrevious` in new subscribers not work until new context changes.\n   */\n  expire(): void {\n    super._clear();\n  }\n\n  /**\n   * Get the value of the next context changes.\n   */\n  untilChange(): Promise<T> {\n    return super._untilNewNotify();\n  }\n}\n"]}

package/index.d.ts

@@ -1,7 +0,0 @@
-export * from './observable.js';
-export * from './simple-signal.js';
-export * from './signal.js';
-export * from './context.js';
-export * from './multithread-context.js';
-export type * from './type.js';
-//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,mBAAmB,WAAW,CAAC"}

package/index.js

@@ -1,6 +0,0 @@
-export * from './observable.js';
-export * from './simple-signal.js';
-export * from './signal.js';
-export * from './context.js';
-export * from './multithread-context.js';
-//# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC","sourcesContent":["export * from './observable.js';\nexport * from './simple-signal.js';\nexport * from './signal.js';\nexport * from './context.js';\nexport * from './multithread-context.js';\nexport type * from './type.js';\n"]}

package/multithread-context.d.ts

@@ -1,21 +0,0 @@
-import { AlwatrContextSignal } from './context.js';
-/**
- * Alwatr multithread context signal.
- */
-export declare class AlwatrMultithreadContextSignal<TValue> extends AlwatrContextSignal<TValue> {
-    protected static _logger: import("@alwatr/logger").AlwatrLogger;
-    protected static _worker?: Worker;
-    protected static _registry: Record<string, AlwatrMultithreadContextSignal<unknown> | undefined>;
-    static setupChannel(worker?: Worker): void;
-    static _onMessage(event: MessageEvent): void;
-    static _postMessage(name: string, payload: unknown): void;
-    constructor(config: {
-        name: string;
-        loggerPrefix?: string;
-    });
-    /**
-     * Set context value and notify all subscribers.
-     */
-    setValue(value: TValue): void;
-}
-//# sourceMappingURL=multithread-context.d.ts.map

package/multithread-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multithread-context.d.ts","sourceRoot":"","sources":["src/multithread-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAQjD;;GAEG;AACH,qBAAa,8BAA8B,CAAC,MAAM,CAAE,SAAQ,mBAAmB,CAAC,MAAM,CAAC;IACrF,SAAS,CAAC,MAAM,CAAC,OAAO,wCAAqC;IAC7D,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAM;IAErG,MAAM,CAAC,YAAY,CAAC,MAAM,GAAE,MAAkC,GAAG,IAAI;IAKrE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAW5C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;gBAY7C,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAC;IAUzD;;OAEG;IACM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAIvC"}

package/multithread-context.js

@@ -1,50 +0,0 @@
-import { createLogger } from '@alwatr/logger';
-import { AlwatrContextSignal } from './context.js';
-/**
- * Alwatr multithread context signal.
- */
-export class AlwatrMultithreadContextSignal extends AlwatrContextSignal {
-    static setupChannel(worker = self) {
-        AlwatrMultithreadContextSignal._worker = worker;
-        worker.addEventListener('message', AlwatrMultithreadContextSignal._onMessage);
-    }
-    static _onMessage(event) {
-        const message = event.data;
-        if (message.type !== 'alwatr_context_changed')
-            return;
-        AlwatrMultithreadContextSignal._logger.logMethodArgs?.('_onMessage', { message });
-        const context = AlwatrMultithreadContextSignal._registry[message.name];
-        if (context === undefined) {
-            throw new Error('context_not_define', { cause: 'context not define in this thread yet!' });
-        }
-        context._notify(message.payload);
-    }
-    static _postMessage(name, payload) {
-        AlwatrMultithreadContextSignal._logger.logMethodArgs?.('_postMessage', { name, payload });
-        if (AlwatrMultithreadContextSignal._worker === undefined) {
-            throw new Error('worker_not_defined', { cause: 'setupChannel must be called before any setValue.' });
-        }
-        AlwatrMultithreadContextSignal._worker.postMessage({
-            type: 'alwatr_context_changed',
-            name,
-            payload,
-        });
-    }
-    constructor(config) {
-        super(config);
-        if (AlwatrMultithreadContextSignal._registry[this._name] !== undefined) {
-            throw new Error('context_name_exist');
-        }
-        AlwatrMultithreadContextSignal._registry[this._name] = this;
-    }
-    /**
-     * Set context value and notify all subscribers.
-     */
-    setValue(value) {
-        super.setValue(value);
-        AlwatrMultithreadContextSignal._postMessage(this._name, value);
-    }
-}
-AlwatrMultithreadContextSignal._logger = createLogger(`alwatr/mt-context`);
-AlwatrMultithreadContextSignal._registry = {};
-//# sourceMappingURL=multithread-context.js.map

package/multithread-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multithread-context.js","sourceRoot":"","sources":["src/multithread-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAQjD;;GAEG;AACH,MAAM,OAAO,8BAAuC,SAAQ,mBAA2B;IAKrF,MAAM,CAAC,YAAY,CAAC,SAAiB,IAAyB;QAC5D,8BAA8B,CAAC,OAAO,GAAG,MAAM,CAAC;QAChD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAAmB;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAmC,CAAC;QAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,wBAAwB;YAAE,OAAO;QACtD,8BAA8B,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,YAAY,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,8BAA8B,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAC,KAAK,EAAE,wCAAwC,EAAC,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAY,EAAE,OAAgB;QAChD,8BAA8B,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,EAAC,IAAI,EAAE,OAAO,EAAC,CAAC,CAAC;QACxF,IAAI,8BAA8B,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAC,KAAK,EAAE,kDAAkD,EAAC,CAAC,CAAC;QACrG,CAAC;QACD,8BAA8B,CAAC,OAAO,CAAC,WAAW,CAAC;YACjD,IAAI,EAAE,wBAAwB;YAC9B,IAAI;YACJ,OAAO;SACuB,CAAC,CAAC;IACpC,CAAC;IAED,YAAY,MAA6C;QACvD,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,8BAA8B,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,8BAA8B,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAA+C,CAAC;IACzG,CAAC;IAED;;OAEG;IACM,QAAQ,CAAC,KAAa;QAC7B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtB,8BAA8B,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;;AAhDgB,sCAAO,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAE5C,wCAAS,GAAwE,EAAE,CAAC","sourcesContent":["import {createLogger} from '@alwatr/logger';\n\nimport {AlwatrContextSignal} from './context.js';\n\ninterface AlwatrContextChangedMessage {\n  type: 'alwatr_context_changed';\n  name: string;\n  payload: unknown;\n}\n\n/**\n * Alwatr multithread context signal.\n */\nexport class AlwatrMultithreadContextSignal<TValue> extends AlwatrContextSignal<TValue> {\n  protected static _logger = createLogger(`alwatr/mt-context`);\n  protected static _worker?: Worker;\n  protected static _registry: Record<string, AlwatrMultithreadContextSignal<unknown> | undefined> = {};\n\n  static setupChannel(worker: Worker = self as unknown as Worker): void {\n    AlwatrMultithreadContextSignal._worker = worker;\n    worker.addEventListener('message', AlwatrMultithreadContextSignal._onMessage);\n  }\n\n  static _onMessage(event: MessageEvent): void {\n    const message = event.data as AlwatrContextChangedMessage;\n    if (message.type !== 'alwatr_context_changed') return;\n    AlwatrMultithreadContextSignal._logger.logMethodArgs?.('_onMessage', {message});\n    const context = AlwatrMultithreadContextSignal._registry[message.name];\n    if (context === undefined) {\n      throw new Error('context_not_define', {cause: 'context not define in this thread yet!'});\n    }\n    context._notify(message.payload);\n  }\n\n  static _postMessage(name: string, payload: unknown): void {\n    AlwatrMultithreadContextSignal._logger.logMethodArgs?.('_postMessage', {name, payload});\n    if (AlwatrMultithreadContextSignal._worker === undefined) {\n      throw new Error('worker_not_defined', {cause: 'setupChannel must be called before any setValue.'});\n    }\n    AlwatrMultithreadContextSignal._worker.postMessage({\n      type: 'alwatr_context_changed',\n      name,\n      payload,\n    } as AlwatrContextChangedMessage);\n  }\n\n  constructor(config: {name: string; loggerPrefix?: string}) {\n    super(config);\n\n    if (AlwatrMultithreadContextSignal._registry[this._name] !== undefined) {\n      throw new Error('context_name_exist');\n    }\n\n    AlwatrMultithreadContextSignal._registry[this._name] = this as AlwatrMultithreadContextSignal<unknown>;\n  }\n\n  /**\n   * Set context value and notify all subscribers.\n   */\n  override setValue(value: TValue): void {\n    super.setValue(value);\n    AlwatrMultithreadContextSignal._postMessage(this._name, value);\n  }\n}\n"]}

package/observable.d.ts

@@ -1,47 +0,0 @@
-import type { SubscribeOptions, ListenerCallback, Observer, SubscribeResult, AlwatrObservableInterface } from './type.js';
-/**
- * Alwatr base signal.
- */
-export declare abstract class AlwatrObservable<T> implements AlwatrObservableInterface<T> {
-    protected _name: string;
-    protected _logger: import("@alwatr/logger").AlwatrLogger;
-    protected _$data?: T;
-    protected _$observers: Observer<this, T>[];
-    constructor(config: {
-        name: string;
-        loggerPrefix?: string;
-    });
-    /**
-     * Get data.
-     *
-     * Return undefined if signal not notify before or expired.
-     */
-    protected _getData(): T | undefined;
-    /**
-     * Execute all observers and remember data.
-     */
-    protected _notify(data: T): void;
-    /**
-     * Execute all observers callback.
-     */
-    protected _$dispatch(data: T): void;
-    /**
-     * Subscribe to context changes.
-     */
-    subscribe(listenerCallback: ListenerCallback<this, T>, options?: SubscribeOptions): SubscribeResult;
-    /**
-     * Unsubscribe from context.
-     */
-    unsubscribe(listenerCallback: ListenerCallback<this, T>): void;
-    /**
-     * Clear current data without notify subscribers.
-     *
-     * `receivePrevious` in new subscribers not work until new a notify changes the data.
-     */
-    protected _clear(): void;
-    /**
-     * Get the data of next notify.
-     */
-    protected _untilNewNotify(): Promise<T>;
-}
-//# sourceMappingURL=observable.d.ts.map

package/observable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["src/observable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,yBAAyB,EAAC,MAAM,WAAW,CAAC;AAIxH;;GAEG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,CAAE,YAAW,yBAAyB,CAAC,CAAC,CAAC;IAC/E,SAAS,CAAC,KAAK,SAAC;IAChB,SAAS,CAAC,OAAO,wCAAC;IAClB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrB,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAM;gBAEpC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAC;IAOzD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,IAAI,CAAC,GAAG,SAAS;IAKnC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMhC;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAuBnC;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe;IAyCvG;;OAEG;IACH,WAAW,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;IAQ9D;;;;OAIG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;IAKxB;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC;CAUxC"}

package/observable.js

@@ -1,127 +0,0 @@
-import { createLogger, definePackage } from '@alwatr/logger';
-definePackage('signal', '2.x');
-/**
- * Alwatr base signal.
- */
-export class AlwatrObservable {
-    constructor(config) {
-        this._$observers = [];
-        config.loggerPrefix ?? (config.loggerPrefix = 'signal');
-        this._name = config.name;
-        this._logger = createLogger(`{${config.loggerPrefix}: ${this._name}}`);
-        this._logger.logMethod?.('constructor');
-    }
-    /**
-     * Get data.
-     *
-     * Return undefined if signal not notify before or expired.
-     */
-    _getData() {
-        this._logger.logMethodFull?.('_getData', {}, this._$data);
-        return this._$data;
-    }
-    /**
-     * Execute all observers and remember data.
-     */
-    _notify(data) {
-        this._logger.logMethodArgs?.('_notify', data);
-        this._$data = data;
-        setTimeout(() => this._$dispatch(data), 0);
-    }
-    /**
-     * Execute all observers callback.
-     */
-    _$dispatch(data) {
-        const removeList = [];
-        for (const listener of this._$observers) {
-            if (listener.options.disabled)
-                continue;
-            if (listener.options.once)
-                removeList.push(listener);
-            try {
-                const ret = listener.callback.call(this, data);
-                if (ret instanceof Promise) {
-                    ret.catch((err) => this._logger.error('_$dispatch', 'call_listener_failed', err));
-                }
-            }
-            catch (err) {
-                this._logger.error('_$dispatch', 'call_listener_failed', err);
-            }
-        }
-        for (const listener of removeList) {
-            this.unsubscribe(listener.callback);
-        }
-    }
-    /**
-     * Subscribe to context changes.
-     */
-    subscribe(listenerCallback, options = {}) {
-        this._logger.logMethodArgs?.('subscribe', { options });
-        const _listenerObject = {
-            callback: listenerCallback,
-            options,
-        };
-        let callbackExecuted = false;
-        const data = this._$data;
-        if (data !== undefined && options.receivePrevious === true && options.disabled !== true) {
-            // Run callback for old dispatch signal
-            callbackExecuted = true;
-            setTimeout(() => {
-                try {
-                    const ret = listenerCallback.call(this, data);
-                    if (ret instanceof Promise) {
-                        ret.catch((err) => this._logger.error('subscribe.receivePrevious', 'call_signal_callback_failed', err));
-                    }
-                }
-                catch (err) {
-                    this._logger.error('subscribe.receivePrevious', 'call_signal_callback_failed', err);
-                }
-            }, 0);
-        }
-        // If once then must remove listener after first callback called! then why push it to listenerList?!
-        if (options.once !== true || callbackExecuted === true) {
-            if (options.priority === true) {
-                this._$observers.unshift(_listenerObject);
-            }
-            else {
-                this._$observers.push(_listenerObject);
-            }
-        }
-        return {
-            unsubscribe: this.unsubscribe.bind(this, listenerCallback),
-        };
-    }
-    /**
-     * Unsubscribe from context.
-     */
-    unsubscribe(listenerCallback) {
-        this._logger.logMethod?.('unsubscribe');
-        const listenerIndex = this._$observers.findIndex((listener) => listener.callback === listenerCallback);
-        if (listenerIndex !== -1) {
-            void this._$observers.splice(listenerIndex, 1);
-        }
-    }
-    /**
-     * Clear current data without notify subscribers.
-     *
-     * `receivePrevious` in new subscribers not work until new a notify changes the data.
-     */
-    _clear() {
-        this._logger.logMethod?.('_clear');
-        this._$data = undefined;
-    }
-    /**
-     * Get the data of next notify.
-     */
-    _untilNewNotify() {
-        this._logger.logMethod?.('_untilNewNotify');
-        return new Promise((resolve) => {
-            this.subscribe(resolve, {
-                once: true,
-                priority: true,
-                receivePrevious: false,
-            });
-        });
-    }
-}
-//# sourceMappingURL=observable.js.map