reactor-core-ts 2.1.6 → 3.2.2

package/dist/schedulers/schedulers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ * Browser scheduler implementations and contracts.
+ */
+import type { DurationInput, Executor, Scheduler } from "./types.js";
+/** Browser-oriented scheduler factories and Reactor-compatible aliases. */
+export declare const Schedulers: Readonly<{
+    /** Returns the synchronous immediate scheduler. */
+    immediate(): Scheduler;
+    /** Returns the shared microtask scheduler. */
+    micro(): Scheduler;
+    /** Returns the shared macrotask scheduler. */
+    macro(): Scheduler;
+    /** Creates a scheduler that applies a default delay when one is not provided per call. */
+    delay(delay: DurationInput, name?: string): Scheduler;
+    /** Creates a scheduler that applies a default interval when one is not provided per call. */
+    interval(period: DurationInput, name?: string): Scheduler;
+    /** Returns the shared animation-frame scheduler. */
+    animationFrame(): Scheduler;
+    /** Returns the shared microtask scheduler using its legacy name. */
+    microtask(): Scheduler;
+    /** Returns the shared macrotask scheduler using its legacy timeout name. */
+    timeout(): Scheduler;
+    /** Returns a shared scheduler suitable for single-threaded work. */
+    single(): Scheduler;
+    /** Returns a shared scheduler suitable for parallel-style browser work. */
+    parallel(): Scheduler;
+    /** Returns a shared scheduler suitable for delayed or blocking-like work. */
+    boundedElastic(): Scheduler;
+    /** Creates a new microtask-backed single scheduler. */
+    newSingle(name?: string): Scheduler;
+    /** Creates a new microtask-backed parallel scheduler. */
+    newParallel(name?: string): Scheduler;
+    /** Creates a new macrotask-backed bounded elastic scheduler. */
+    newBoundedElastic(name?: string): Scheduler;
+    /** Creates a scheduler backed by a custom executor. */
+    fromExecutor(executor: Executor, name?: string): Scheduler;
+}>;
+//# sourceMappingURL=schedulers.d.ts.map

package/dist/schedulers/schedulers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedulers.d.ts","sourceRoot":"","sources":["../../src/schedulers/schedulers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAkB9E,2EAA2E;AAC3E,eAAO,MAAM,UAAU;IACnB,mDAAmD;iBACtC,SAAS;IAItB,8CAA8C;aACrC,SAAS;IAIlB,8CAA8C;aACrC,SAAS;IAIlB,0FAA0F;iBAC7E,aAAa,kBAAmB,SAAS;IAItD,6FAA6F;qBAC5E,aAAa,kBAAsB,SAAS;IAI7D,oDAAoD;sBAClC,SAAS;IAI3B,oEAAoE;iBACvD,SAAS;IAItB,4EAA4E;eACjE,SAAS;IAIpB,oEAAoE;cAC1D,SAAS;IAInB,2EAA2E;gBAC/D,SAAS;IAIrB,6EAA6E;sBAC3D,SAAS;IAI3B,uDAAuD;8BAC3B,SAAS;IAIrC,yDAAyD;gCACzB,SAAS;IAIzC,gEAAgE;sCACpB,SAAS;IAIrD,uDAAuD;2BAChC,QAAQ,kBAAsB,SAAS;EAGhE,CAAC"}

package/dist/schedulers/schedulers.js

@@ -0,0 +1,83 @@
+import { AnimationFrameScheduler } from "./animation-frame-scheduler.js";
+import { MacroScheduler } from "./macro-scheduler.js";
+import { DelayScheduler } from "./delay-scheduler.js";
+import { ExecutorScheduler } from "./executor-scheduler.js";
+import { ImmediateScheduler } from "./immediate-scheduler.js";
+import { IntervalScheduler } from "./interval-scheduler.js";
+import { MicrotaskScheduler } from "./microtask-scheduler.js";
+//#region src/schedulers/schedulers.ts
+/** Shared scheduler that executes work synchronously. */
+var immediateScheduler = new ImmediateScheduler();
+/** Shared scheduler that queues work through the microtask queue. */
+var microScheduler = new MicrotaskScheduler("micro");
+/** Shared scheduler that queues work through the macrotask queue. */
+var macroScheduler = new MacroScheduler();
+/** Shared scheduler that queues work with `requestAnimationFrame` when available. */
+var animationFrameScheduler = new AnimationFrameScheduler();
+/** Browser-oriented scheduler factories and Reactor-compatible aliases. */
+var Schedulers = Object.freeze({
+	/** Returns the synchronous immediate scheduler. */
+	immediate() {
+		return immediateScheduler;
+	},
+	/** Returns the shared microtask scheduler. */
+	micro() {
+		return microScheduler;
+	},
+	/** Returns the shared macrotask scheduler. */
+	macro() {
+		return macroScheduler;
+	},
+	/** Creates a scheduler that applies a default delay when one is not provided per call. */
+	delay(delay, name = "delay") {
+		return new DelayScheduler(delay, name);
+	},
+	/** Creates a scheduler that applies a default interval when one is not provided per call. */
+	interval(period, name = "interval") {
+		return new IntervalScheduler(period, name);
+	},
+	/** Returns the shared animation-frame scheduler. */
+	animationFrame() {
+		return animationFrameScheduler;
+	},
+	/** Returns the shared microtask scheduler using its legacy name. */
+	microtask() {
+		return microScheduler;
+	},
+	/** Returns the shared macrotask scheduler using its legacy timeout name. */
+	timeout() {
+		return macroScheduler;
+	},
+	/** Returns a shared scheduler suitable for single-threaded work. */
+	single() {
+		return microScheduler;
+	},
+	/** Returns a shared scheduler suitable for parallel-style browser work. */
+	parallel() {
+		return microScheduler;
+	},
+	/** Returns a shared scheduler suitable for delayed or blocking-like work. */
+	boundedElastic() {
+		return macroScheduler;
+	},
+	/** Creates a new microtask-backed single scheduler. */
+	newSingle(name = "single") {
+		return new MicrotaskScheduler(name);
+	},
+	/** Creates a new microtask-backed parallel scheduler. */
+	newParallel(name = "parallel") {
+		return new MicrotaskScheduler(name);
+	},
+	/** Creates a new macrotask-backed bounded elastic scheduler. */
+	newBoundedElastic(name = "boundedElastic") {
+		return new MacroScheduler(name);
+	},
+	/** Creates a scheduler backed by a custom executor. */
+	fromExecutor(executor, name = "executor") {
+		return new ExecutorScheduler(name, executor);
+	}
+});
+//#endregion
+export { Schedulers };
+
+//# sourceMappingURL=schedulers.js.map

package/dist/schedulers/schedulers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedulers.js","names":[],"sources":["../../src/schedulers/schedulers.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Browser scheduler implementations and contracts.\n */\nimport type {DurationInput, Executor, Scheduler} from \"@/schedulers/types.js\";\nimport {AnimationFrameScheduler} from \"@/schedulers/animation-frame-scheduler.js\";\nimport {DelayScheduler} from \"@/schedulers/delay-scheduler.js\";\nimport {ExecutorScheduler} from \"@/schedulers/executor-scheduler.js\";\nimport {ImmediateScheduler} from \"@/schedulers/immediate-scheduler.js\";\nimport {IntervalScheduler} from \"@/schedulers/interval-scheduler.js\";\nimport {MacroScheduler} from \"@/schedulers/macro-scheduler.js\";\nimport {MicrotaskScheduler} from \"@/schedulers/microtask-scheduler.js\";\n\n/** Shared scheduler that executes work synchronously. */\nconst immediateScheduler = new ImmediateScheduler();\n/** Shared scheduler that queues work through the microtask queue. */\nconst microScheduler = new MicrotaskScheduler(\"micro\");\n/** Shared scheduler that queues work through the macrotask queue. */\nconst macroScheduler = new MacroScheduler();\n/** Shared scheduler that queues work with `requestAnimationFrame` when available. */\nconst animationFrameScheduler = new AnimationFrameScheduler();\n\n/** Browser-oriented scheduler factories and Reactor-compatible aliases. */\nexport const Schedulers = Object.freeze({\n    /** Returns the synchronous immediate scheduler. */\n    immediate(): Scheduler {\n        return immediateScheduler;\n    },\n\n    /** Returns the shared microtask scheduler. */\n    micro(): Scheduler {\n        return microScheduler;\n    },\n\n    /** Returns the shared macrotask scheduler. */\n    macro(): Scheduler {\n        return macroScheduler;\n    },\n\n    /** Creates a scheduler that applies a default delay when one is not provided per call. */\n    delay(delay: DurationInput, name = \"delay\"): Scheduler {\n        return new DelayScheduler(delay, name);\n    },\n\n    /** Creates a scheduler that applies a default interval when one is not provided per call. */\n    interval(period: DurationInput, name = \"interval\"): Scheduler {\n        return new IntervalScheduler(period, name);\n    },\n\n    /** Returns the shared animation-frame scheduler. */\n    animationFrame(): Scheduler {\n        return animationFrameScheduler;\n    },\n\n    /** Returns the shared microtask scheduler using its legacy name. */\n    microtask(): Scheduler {\n        return microScheduler;\n    },\n\n    /** Returns the shared macrotask scheduler using its legacy timeout name. */\n    timeout(): Scheduler {\n        return macroScheduler;\n    },\n\n    /** Returns a shared scheduler suitable for single-threaded work. */\n    single(): Scheduler {\n        return microScheduler;\n    },\n\n    /** Returns a shared scheduler suitable for parallel-style browser work. */\n    parallel(): Scheduler {\n        return microScheduler;\n    },\n\n    /** Returns a shared scheduler suitable for delayed or blocking-like work. */\n    boundedElastic(): Scheduler {\n        return macroScheduler;\n    },\n\n    /** Creates a new microtask-backed single scheduler. */\n    newSingle(name = \"single\"): Scheduler {\n        return new MicrotaskScheduler(name);\n    },\n\n    /** Creates a new microtask-backed parallel scheduler. */\n    newParallel(name = \"parallel\"): Scheduler {\n        return new MicrotaskScheduler(name);\n    },\n\n    /** Creates a new macrotask-backed bounded elastic scheduler. */\n    newBoundedElastic(name = \"boundedElastic\"): Scheduler {\n        return new MacroScheduler(name);\n    },\n\n    /** Creates a scheduler backed by a custom executor. */\n    fromExecutor(executor: Executor, name = \"executor\"): Scheduler {\n        return new ExecutorScheduler(name, executor);\n    }\n});\n"],"mappings":";;;;;;;;;AAcA,IAAM,qBAAqB,IAAI,mBAAmB;;AAElD,IAAM,iBAAiB,IAAI,mBAAmB,OAAO;;AAErD,IAAM,iBAAiB,IAAI,eAAe;;AAE1C,IAAM,0BAA0B,IAAI,wBAAwB;;AAG5D,IAAa,aAAa,OAAO,OAAO;;CAEpC,YAAuB;EACnB,OAAO;CACX;;CAGA,QAAmB;EACf,OAAO;CACX;;CAGA,QAAmB;EACf,OAAO;CACX;;CAGA,MAAM,OAAsB,OAAO,SAAoB;EACnD,OAAO,IAAI,eAAe,OAAO,IAAI;CACzC;;CAGA,SAAS,QAAuB,OAAO,YAAuB;EAC1D,OAAO,IAAI,kBAAkB,QAAQ,IAAI;CAC7C;;CAGA,iBAA4B;EACxB,OAAO;CACX;;CAGA,YAAuB;EACnB,OAAO;CACX;;CAGA,UAAqB;EACjB,OAAO;CACX;;CAGA,SAAoB;EAChB,OAAO;CACX;;CAGA,WAAsB;EAClB,OAAO;CACX;;CAGA,iBAA4B;EACxB,OAAO;CACX;;CAGA,UAAU,OAAO,UAAqB;EAClC,OAAO,IAAI,mBAAmB,IAAI;CACtC;;CAGA,YAAY,OAAO,YAAuB;EACtC,OAAO,IAAI,mBAAmB,IAAI;CACtC;;CAGA,kBAAkB,OAAO,kBAA6B;EAClD,OAAO,IAAI,eAAe,IAAI;CAClC;;CAGA,aAAa,UAAoB,OAAO,YAAuB;EAC3D,OAAO,IAAI,kBAAkB,MAAM,QAAQ;CAC/C;AACJ,CAAC"}

package/dist/schedulers/timeout-scheduler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @packageDocumentation
+ * Browser scheduler implementations and contracts.
+ */
+import { MacroScheduler } from "./macro-scheduler.js";
+/** Compatibility scheduler name for timeout-backed macrotask scheduling. */
+export declare class TimeoutScheduler extends MacroScheduler {
+    /** Creates a timeout-named macrotask scheduler. */
+    constructor(name?: string);
+}
+//# sourceMappingURL=timeout-scheduler.d.ts.map

package/dist/schedulers/timeout-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-scheduler.d.ts","sourceRoot":"","sources":["../../src/schedulers/timeout-scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAC;AAE/D,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,cAAc;IAChD,mDAAmD;IACnD,YAAmB,IAAI,SAAY,EAElC;CACJ"}

package/dist/schedulers/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @packageDocumentation
+ * Browser scheduler implementations and contracts.
+ */
+import type { Disposable } from "../core/types.js";
+/** Duration accepted by browser schedulers, expressed in milliseconds or fields. */
+export type DurationInput = number | {
+    milliseconds?: number;
+    seconds?: number;
+    minutes?: number;
+    hours?: number;
+};
+/** Scheduler capable of executing immediate, delayed and periodic tasks. */
+export interface Scheduler extends Disposable {
+    /** Human-readable scheduler name. */
+    readonly name: string;
+    /** Returns the current scheduler time in milliseconds. */
+    now(): number;
+    /** Schedules a single task, optionally after a delay. */
+    schedule(task: () => void, delay?: DurationInput): Disposable;
+    /** Schedules a repeated task. */
+    schedulePeriodically(task: () => void, initialDelay?: DurationInput, period?: DurationInput): Disposable;
+    /** Creates a worker that can dispose a group of tasks together. */
+    createWorker(): SchedulerWorker;
+}
+/** Worker groups scheduled tasks for coordinated disposal. */
+export interface SchedulerWorker extends Disposable {
+    /** Schedules a single task on this worker. */
+    schedule(task: () => void, delay?: DurationInput): Disposable;
+    /** Schedules a repeated task on this worker. */
+    schedulePeriodically(task: () => void, initialDelay?: DurationInput, period?: DurationInput): Disposable;
+}
+/** Function that accepts a task for execution. */
+export type Executor = (task: () => void) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/schedulers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schedulers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAEhD,oFAAoF;AACpF,MAAM,MAAM,aAAa,GACnB,MAAM,GACN;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,WAAW,SAAU,SAAQ,UAAU;IACzC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,0DAA0D;IAC1D,GAAG,IAAI,MAAM,CAAC;IAEd,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAE9D,iCAAiC;IACjC,oBAAoB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,YAAY,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAEzG,mEAAmE;IACnE,YAAY,IAAI,eAAe,CAAC;CACnC;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAC/C,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAE9D,gDAAgD;IAChD,oBAAoB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,YAAY,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;CAC5G;AAED,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC"}

package/dist/signal/signal-type.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @packageDocumentation
+ * Materialized signal representation and signal kinds.
+ */
+/** Reactive signal kinds used by materialize/dematerialize and sink handlers. */
+export declare enum SignalType {
+    /** Subscription signal. */
+    SUBSCRIBE = "subscribe",
+    /** Request signal. */
+    REQUEST = "request",
+    /** Cancellation signal. */
+    CANCEL = "cancel",
+    /** Next value signal. */
+    NEXT = "next",
+    /** Error terminal signal. */
+    ERROR = "error",
+    /** Complete terminal signal. */
+    COMPLETE = "complete",
+    /** Post-termination callback signal. */
+    AFTER_TERMINATE = "afterTerminate",
+    /** Current context lookup signal. */
+    CURRENT_CONTEXT = "currentContext",
+    /** Context write signal. */
+    ON_CONTEXT = "onContext"
+}
+//# sourceMappingURL=signal-type.d.ts.map

package/dist/signal/signal-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-type.d.ts","sourceRoot":"","sources":["../../src/signal/signal-type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,iFAAiF;AACjF,oBAAY,UAAU;IAClB,2BAA2B;IAC3B,SAAS,cAAc;IACvB,sBAAsB;IACtB,OAAO,YAAY;IACnB,2BAA2B;IAC3B,MAAM,WAAW;IACjB,yBAAyB;IACzB,IAAI,SAAS;IACb,6BAA6B;IAC7B,KAAK,UAAU;IACf,gCAAgC;IAChC,QAAQ,aAAa;IACrB,wCAAwC;IACxC,eAAe,mBAAmB;IAClC,qCAAqC;IACrC,eAAe,mBAAmB;IAClC,4BAA4B;IAC5B,UAAU,cAAc;CAC3B"}

package/dist/signal/signal-type.js

@@ -0,0 +1,31 @@
+//#region src/signal/signal-type.ts
+/**
+* @packageDocumentation
+* Materialized signal representation and signal kinds.
+*/
+/** Reactive signal kinds used by materialize/dematerialize and sink handlers. */
+var SignalType = /* @__PURE__ */ function(SignalType) {
+	/** Subscription signal. */
+	SignalType["SUBSCRIBE"] = "subscribe";
+	/** Request signal. */
+	SignalType["REQUEST"] = "request";
+	/** Cancellation signal. */
+	SignalType["CANCEL"] = "cancel";
+	/** Next value signal. */
+	SignalType["NEXT"] = "next";
+	/** Error terminal signal. */
+	SignalType["ERROR"] = "error";
+	/** Complete terminal signal. */
+	SignalType["COMPLETE"] = "complete";
+	/** Post-termination callback signal. */
+	SignalType["AFTER_TERMINATE"] = "afterTerminate";
+	/** Current context lookup signal. */
+	SignalType["CURRENT_CONTEXT"] = "currentContext";
+	/** Context write signal. */
+	SignalType["ON_CONTEXT"] = "onContext";
+	return SignalType;
+}({});
+//#endregion
+export { SignalType };
+
+//# sourceMappingURL=signal-type.js.map

package/dist/signal/signal-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-type.js","names":[],"sources":["../../src/signal/signal-type.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Materialized signal representation and signal kinds.\n */\n/** Reactive signal kinds used by materialize/dematerialize and sink handlers. */\nexport enum SignalType {\n    /** Subscription signal. */\n    SUBSCRIBE = \"subscribe\",\n    /** Request signal. */\n    REQUEST = \"request\",\n    /** Cancellation signal. */\n    CANCEL = \"cancel\",\n    /** Next value signal. */\n    NEXT = \"next\",\n    /** Error terminal signal. */\n    ERROR = \"error\",\n    /** Complete terminal signal. */\n    COMPLETE = \"complete\",\n    /** Post-termination callback signal. */\n    AFTER_TERMINATE = \"afterTerminate\",\n    /** Current context lookup signal. */\n    CURRENT_CONTEXT = \"currentContext\",\n    /** Context write signal. */\n    ON_CONTEXT = \"onContext\"\n}\n"],"mappings":";;;;;;AAKA,IAAY,aAAL,yBAAA,YAAA;;CAEH,WAAA,eAAA;;CAEA,WAAA,aAAA;;CAEA,WAAA,YAAA;;CAEA,WAAA,UAAA;;CAEA,WAAA,WAAA;;CAEA,WAAA,cAAA;;CAEA,WAAA,qBAAA;;CAEA,WAAA,qBAAA;;CAEA,WAAA,gBAAA;;AACJ,EAAA,CAAA,CAAA"}

package/dist/signal/signal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @packageDocumentation
+ * Materialized signal representation and signal kinds.
+ */
+import { SignalType } from "./signal-type.js";
+/** Immutable representation of a Reactor signal. */
+export declare class Signal<T> {
+    /** Signal kind represented by this instance. */
+    readonly type: SignalType;
+    /** Value carried by onNext signals. */
+    readonly value: T | undefined;
+    /** Error carried by onError signals. */
+    readonly error: unknown;
+    /** Creates an immutable signal value. */
+    private constructor();
+    /** Creates an onNext signal. */
+    static next<T>(value: T): Signal<T>;
+    /** Creates an onError signal. */
+    static error<T = never>(error: unknown): Signal<T>;
+    /** Creates an onComplete signal. */
+    static complete<T = never>(): Signal<T>;
+    /** Returns true for onNext signals. */
+    isOnNext(): boolean;
+    /** Returns true for onError signals. */
+    isOnError(): boolean;
+    /** Returns true for onComplete signals. */
+    isOnComplete(): boolean;
+    /** Returns the signal value when present. */
+    get(): T | undefined;
+    /** Returns the signal error when present. */
+    getThrowable(): unknown;
+}
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/signal/signal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AAEnD,oDAAoD;AACpD,qBAAa,MAAM,CAAC,CAAC;IACjB,gDAAgD;IAChD,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,uCAAuC;IACvC,SAAgB,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrC,wCAAwC;IACxC,SAAgB,KAAK,EAAE,OAAO,CAAC;IAE/B,yCAAyC;IACzC,OAAO,eAIN;IAED,gCAAgC;IAChC,OAAc,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEzC;IAED,iCAAiC;IACjC,OAAc,KAAK,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAExD;IAED,oCAAoC;IACpC,OAAc,QAAQ,CAAC,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAE7C;IAED,uCAAuC;IAChC,QAAQ,IAAI,OAAO,CAEzB;IAED,wCAAwC;IACjC,SAAS,IAAI,OAAO,CAE1B;IAED,2CAA2C;IACpC,YAAY,IAAI,OAAO,CAE7B;IAED,6CAA6C;IACtC,GAAG,IAAI,CAAC,GAAG,SAAS,CAE1B;IAED,6CAA6C;IACtC,YAAY,IAAI,OAAO,CAE7B;CACJ"}

package/dist/signal/signal.js

@@ -0,0 +1,70 @@
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { SignalType } from "./signal-type.js";
+//#region src/signal/signal.ts
+/**
+* @packageDocumentation
+* Materialized signal representation and signal kinds.
+*/
+/** Immutable representation of a Reactor signal. */
+var Signal = class Signal {
+	/** Creates an immutable signal value. */
+	constructor(type, value, error) {
+		_defineProperty(
+			this,
+			/** Signal kind represented by this instance. */
+			"type",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Value carried by onNext signals. */
+			"value",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Error carried by onError signals. */
+			"error",
+			void 0
+		);
+		this.type = type;
+		this.value = value;
+		this.error = error;
+	}
+	/** Creates an onNext signal. */
+	static next(value) {
+		return new Signal(SignalType.NEXT, value);
+	}
+	/** Creates an onError signal. */
+	static error(error) {
+		return new Signal(SignalType.ERROR, void 0, error);
+	}
+	/** Creates an onComplete signal. */
+	static complete() {
+		return new Signal(SignalType.COMPLETE);
+	}
+	/** Returns true for onNext signals. */
+	isOnNext() {
+		return this.type === SignalType.NEXT;
+	}
+	/** Returns true for onError signals. */
+	isOnError() {
+		return this.type === SignalType.ERROR;
+	}
+	/** Returns true for onComplete signals. */
+	isOnComplete() {
+		return this.type === SignalType.COMPLETE;
+	}
+	/** Returns the signal value when present. */
+	get() {
+		return this.value;
+	}
+	/** Returns the signal error when present. */
+	getThrowable() {
+		return this.error;
+	}
+};
+//#endregion
+export { Signal };
+
+//# sourceMappingURL=signal.js.map

package/dist/signal/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","names":[],"sources":["../../src/signal/signal.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Materialized signal representation and signal kinds.\n */\nimport {SignalType} from \"@/signal/signal-type.js\";\n\n/** Immutable representation of a Reactor signal. */\nexport class Signal<T> {\n    /** Signal kind represented by this instance. */\n    public readonly type: SignalType;\n    /** Value carried by onNext signals. */\n    public readonly value: T | undefined;\n    /** Error carried by onError signals. */\n    public readonly error: unknown;\n\n    /** Creates an immutable signal value. */\n    private constructor(type: SignalType, value?: T, error?: unknown) {\n        this.type = type;\n        this.value = value;\n        this.error = error;\n    }\n\n    /** Creates an onNext signal. */\n    public static next<T>(value: T): Signal<T> {\n        return new Signal(SignalType.NEXT, value);\n    }\n\n    /** Creates an onError signal. */\n    public static error<T = never>(error: unknown): Signal<T> {\n        return new Signal<T>(SignalType.ERROR, undefined, error);\n    }\n\n    /** Creates an onComplete signal. */\n    public static complete<T = never>(): Signal<T> {\n        return new Signal<T>(SignalType.COMPLETE);\n    }\n\n    /** Returns true for onNext signals. */\n    public isOnNext(): boolean {\n        return this.type === SignalType.NEXT;\n    }\n\n    /** Returns true for onError signals. */\n    public isOnError(): boolean {\n        return this.type === SignalType.ERROR;\n    }\n\n    /** Returns true for onComplete signals. */\n    public isOnComplete(): boolean {\n        return this.type === SignalType.COMPLETE;\n    }\n\n    /** Returns the signal value when present. */\n    public get(): T | undefined {\n        return this.value;\n    }\n\n    /** Returns the signal error when present. */\n    public getThrowable(): unknown {\n        return this.error;\n    }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,SAAb,MAAa,OAAU;;CASnB,YAAoB,MAAkB,OAAW,OAAiB;;;;GAPlE;;;;;;GAEA;;;;;;GAEA;;;EAII,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,QAAQ;CACjB;;CAGA,OAAc,KAAQ,OAAqB;EACvC,OAAO,IAAI,OAAO,WAAW,MAAM,KAAK;CAC5C;;CAGA,OAAc,MAAiB,OAA2B;EACtD,OAAO,IAAI,OAAU,WAAW,OAAO,QAAW,KAAK;CAC3D;;CAGA,OAAc,WAAiC;EAC3C,OAAO,IAAI,OAAU,WAAW,QAAQ;CAC5C;;CAGA,WAA2B;EACvB,OAAO,KAAK,SAAS,WAAW;CACpC;;CAGA,YAA4B;EACxB,OAAO,KAAK,SAAS,WAAW;CACpC;;CAGA,eAA+B;EAC3B,OAAO,KAAK,SAAS,WAAW;CACpC;;CAGA,MAA4B;EACxB,OAAO,KAAK;CAChB;;CAGA,eAA+B;EAC3B,OAAO,KAAK;CAChB;AACJ"}

package/dist/sinks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @packageDocumentation
+ * Sink specifications and default browser-oriented sink implementations.
+ */
+/** Public Sinks entrypoint. */
+export { Sinks } from "./specs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sinks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,+BAA+B;AAC/B,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/sinks/index.js

@@ -0,0 +1,2 @@
+import { Sinks } from "./specs.js";
+export { Sinks };

package/dist/sinks/many.d.ts

@@ -0,0 +1,66 @@
+import { Flux } from "../publisher/flux.js";
+import type { PublisherInput } from "../publisher/types.js";
+import { SignalType } from "../signal/signal-type.js";
+import { type EmitFailureHandler, EmitResult, type ManySink } from "./types.js";
+/** Delivery mode supported by the default many-valued sink. */
+type ManyMode = "unicast" | "unicast-error" | "multicast-buffer" | "multicast-direct" | "replay";
+/** Configuration for a many-valued sink implementation. */
+export interface ManyOptions<T> {
+    /** Delivery mode used by the sink. */
+    mode: ManyMode;
+    /** Maximum number of replayed values retained in history. */
+    replayLimit?: number;
+    /** Initial value replayed by latest-or-default sinks. */
+    latestDefault?: T;
+}
+/** Default implementation for unicast, multicast and replay many-valued sinks. */
+export declare class DefaultManySink<T> implements ManySink<T> {
+    /** Active subscriber queues currently receiving live values. */
+    private subscribers;
+    /** Values buffered before a non-replay sink receives its first subscriber. */
+    private pending;
+    /** Values retained for replay subscribers. */
+    private history;
+    /** Ring-buffer index of the oldest replay value. */
+    private historyHead;
+    /** Terminal state when the sink has completed or failed. */
+    private terminated;
+    /** Error retained for late subscribers after failure. */
+    private errorValue;
+    /** Tracks whether a unicast sink already accepted its single subscriber. */
+    private unicastAttached;
+    /** Construction options controlling delivery and replay behavior. */
+    private readonly options;
+    /** Creates a many-valued sink with the provided delivery mode. */
+    constructor(options: ManyOptions<T>);
+    /** Returns the Flux view of this sink. */
+    asFlux(): Flux<T>;
+    /** Attempts to emit a value to current subscribers. */
+    tryEmitNext(value: T): EmitResult;
+    /** Attempts to complete this sink. */
+    tryEmitComplete(): EmitResult;
+    /** Attempts to fail this sink. */
+    tryEmitError(error: unknown): EmitResult;
+    /** Emits a value or delegates failure handling to the provided handler. */
+    emitNext(value: T, handler?: EmitFailureHandler): void;
+    /** Completes this sink or delegates failure handling to the provided handler. */
+    emitComplete(handler?: EmitFailureHandler): void;
+    /** Fails this sink or delegates failure handling to the provided handler. */
+    emitError(error: unknown, handler?: EmitFailureHandler): void;
+    /** Returns the current number of active subscribers. */
+    currentSubscriberCount(): number;
+    /** Subscribes this sink to an upstream publisher and relays its signals. */
+    subscribeTo(source: PublisherInput<T>): void;
+    /** Handles an emission failure and returns false to fail fast by default. */
+    onEmitFailure(_signalType: SignalType, _emitResult: EmitResult): boolean;
+    /** Adds a subscriber queue and removes it again when its subscription is cancelled. */
+    private addSubscriber;
+    /** Removes a subscriber queue and releases the set when it becomes empty. */
+    private removeSubscriber;
+    /** Clears and releases all active subscriber queues. */
+    private clearSubscribers;
+    /** Records one value into replay history, allocating history only for replay sinks. */
+    private rememberHistory;
+}
+export {};
+//# sourceMappingURL=many.d.ts.map

package/dist/sinks/many.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.d.ts","sourceRoot":"","sources":["../../src/sinks/many.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AACzC,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AAQnD,OAAO,EAAC,KAAK,kBAAkB,EAAoC,UAAU,EAAE,KAAK,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAEtH,+DAA+D;AAC/D,KAAK,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEjG,2DAA2D;AAC3D,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,sCAAsC;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,aAAa,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,kFAAkF;AAClF,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAClD,gEAAgE;IAChE,OAAO,CAAC,WAAW,CAAiC;IACpD,8EAA8E;IAC9E,OAAO,CAAC,OAAO,CAAkB;IACjC,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,WAAW,CAAK;IACxB,4DAA4D;IAC5D,OAAO,CAAC,UAAU,CAAmC;IACrD,yDAAyD;IACzD,OAAO,CAAC,UAAU,CAAU;IAC5B,4EAA4E;IAC5E,OAAO,CAAC,eAAe,CAAS;IAChC,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,kEAAkE;IAClE,YAAmB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAKzC;IAED,0CAA0C;IACnC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAgCvB;IAED,uDAAuD;IAChD,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAyBvC;IAED,sCAAsC;IAC/B,eAAe,IAAI,UAAU,CAkBnC;IAED,kCAAkC;IAC3B,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAmB9C;IAED,2EAA2E;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAE3F;IAED,iFAAiF;IAC1E,YAAY,CAAC,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAErF;IAED,6EAA6E;IACtE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAElG;IAED,wDAAwD;IACjD,sBAAsB,IAAI,MAAM,CAEtC;IAED,4EAA4E;IACrE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAMlD;IAED,6EAA6E;IACtE,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,OAAO,CAE9E;IAED,uFAAuF;IACvF,OAAO,CAAC,aAAa;IAKrB,6EAA6E;IAC7E,OAAO,CAAC,gBAAgB;IAIxB,wDAAwD;IACxD,OAAO,CAAC,gBAAgB;IAKxB,uFAAuF;IACvF,OAAO,CAAC,eAAe;CAkB1B"}