reactor-core-ts 2.1.6 → 3.2.2

package/dist/sinks/many.js

@@ -0,0 +1,193 @@
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { AsyncQueue } from "../internal/async-queue.js";
+import { Flux } from "../publisher/flux.js";
+import { SignalType } from "../signal/signal-type.js";
+import { addSinkSubscriber, clearSinkSubscribers, removeSinkSubscriber, sinkSubscriberCount } from "./subscribers.js";
+import { EmitFailureHandlers, EmitResult, emitOrThrow } from "./types.js";
+//#region src/sinks/many.ts
+/**
+* @packageDocumentation
+* Sink specifications and default browser-oriented sink implementations.
+*/
+/** Default implementation for unicast, multicast and replay many-valued sinks. */
+var DefaultManySink = class {
+	/** Creates a many-valued sink with the provided delivery mode. */
+	constructor(options) {
+		_defineProperty(
+			this,
+			/** Active subscriber queues currently receiving live values. */
+			"subscribers",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Values buffered before a non-replay sink receives its first subscriber. */
+			"pending",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Values retained for replay subscribers. */
+			"history",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Ring-buffer index of the oldest replay value. */
+			"historyHead",
+			0
+		);
+		_defineProperty(
+			this,
+			/** Terminal state when the sink has completed or failed. */
+			"terminated",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Error retained for late subscribers after failure. */
+			"errorValue",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Tracks whether a unicast sink already accepted its single subscriber. */
+			"unicastAttached",
+			false
+		);
+		_defineProperty(
+			this,
+			/** Construction options controlling delivery and replay behavior. */
+			"options",
+			void 0
+		);
+		this.options = options;
+		if (options.latestDefault !== void 0) this.rememberHistory(options.latestDefault);
+	}
+	/** Returns the Flux view of this sink. */
+	asFlux() {
+		return new Flux((signal) => {
+			const queue = new AsyncQueue(signal);
+			if (isUnicast(this.options.mode) && this.unicastAttached) {
+				queue.error(/* @__PURE__ */ new Error("Unicast sink allows only one subscriber"));
+				return queue;
+			}
+			if (isUnicast(this.options.mode)) this.unicastAttached = true;
+			const history = this.history;
+			if (history) for (let index = 0; index < history.length; index += 1) queue.push(historyValue(history, this.historyHead, index));
+			if (this.pending && this.pending.length > 0) {
+				const pending = this.pending;
+				this.pending = void 0;
+				for (const value of pending) queue.push(value);
+			}
+			if (this.terminated === "complete") queue.complete();
+			else if (this.terminated === "error") queue.error(this.errorValue);
+			else this.addSubscriber(queue, signal);
+			return queue;
+		});
+	}
+	/** Attempts to emit a value to current subscribers. */
+	tryEmitNext(value) {
+		if (this.terminated) return EmitResult.FAIL_TERMINATED;
+		if (this.options.mode === "replay") this.rememberHistory(value);
+		const subscribers = this.subscribers;
+		if (!subscribers) {
+			if (this.options.mode === "multicast-direct" || this.options.mode === "unicast-error") return EmitResult.FAIL_ZERO_SUBSCRIBER;
+			if (this.options.mode !== "replay") (this.pending ?? (this.pending = [])).push(value);
+			return EmitResult.OK;
+		}
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.push(value);
+		else subscribers.push(value);
+		return EmitResult.OK;
+	}
+	/** Attempts to complete this sink. */
+	tryEmitComplete() {
+		if (this.terminated) return EmitResult.FAIL_TERMINATED;
+		const subscribers = this.subscribers;
+		if (this.options.mode === "unicast-error" && !subscribers) return EmitResult.FAIL_ZERO_SUBSCRIBER;
+		this.terminated = "complete";
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.complete();
+		else if (subscribers) subscribers.complete();
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Attempts to fail this sink. */
+	tryEmitError(error) {
+		if (this.terminated) return EmitResult.FAIL_TERMINATED;
+		const subscribers = this.subscribers;
+		if (this.options.mode === "unicast-error" && !subscribers) return EmitResult.FAIL_ZERO_SUBSCRIBER;
+		this.terminated = "error";
+		this.errorValue = error;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.error(error);
+		else if (subscribers) subscribers.error(error);
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Emits a value or delegates failure handling to the provided handler. */
+	emitNext(value, handler = EmitFailureHandlers.FAIL_FAST) {
+		emitOrThrow(SignalType.NEXT, () => this.tryEmitNext(value), handler);
+	}
+	/** Completes this sink or delegates failure handling to the provided handler. */
+	emitComplete(handler = EmitFailureHandlers.FAIL_FAST) {
+		emitOrThrow(SignalType.COMPLETE, () => this.tryEmitComplete(), handler);
+	}
+	/** Fails this sink or delegates failure handling to the provided handler. */
+	emitError(error, handler = EmitFailureHandlers.FAIL_FAST) {
+		emitOrThrow(SignalType.ERROR, () => this.tryEmitError(error), handler, error);
+	}
+	/** Returns the current number of active subscribers. */
+	currentSubscriberCount() {
+		return sinkSubscriberCount(this.subscribers);
+	}
+	/** Subscribes this sink to an upstream publisher and relays its signals. */
+	subscribeTo(source) {
+		Flux.from(source).subscribe((value) => this.emitNext(value), (error) => this.emitError(error), () => this.emitComplete());
+	}
+	/** Handles an emission failure and returns false to fail fast by default. */
+	onEmitFailure(_signalType, _emitResult) {
+		return false;
+	}
+	/** Adds a subscriber queue and removes it again when its subscription is cancelled. */
+	addSubscriber(queue, signal) {
+		this.subscribers = addSinkSubscriber(this.subscribers, queue);
+		signal.addEventListener("abort", () => this.removeSubscriber(queue), { once: true });
+	}
+	/** Removes a subscriber queue and releases the set when it becomes empty. */
+	removeSubscriber(queue) {
+		this.subscribers = removeSinkSubscriber(this.subscribers, queue);
+	}
+	/** Clears and releases all active subscriber queues. */
+	clearSubscribers() {
+		clearSinkSubscribers(this.subscribers);
+		this.subscribers = void 0;
+	}
+	/** Records one value into replay history, allocating history only for replay sinks. */
+	rememberHistory(value) {
+		const limit = this.options.replayLimit ?? Number.POSITIVE_INFINITY;
+		if (limit <= 0) return;
+		const history = this.history;
+		if (!history) {
+			this.history = [value];
+			this.historyHead = 0;
+			return;
+		}
+		if (history.length < limit) {
+			history.push(value);
+			return;
+		}
+		history[this.historyHead] = value;
+		this.historyHead = (this.historyHead + 1) % history.length;
+	}
+};
+/** Returns true for sink modes that allow exactly one subscriber. */
+function isUnicast(mode) {
+	return mode === "unicast" || mode === "unicast-error";
+}
+/** Returns a replay history value in oldest-to-newest order. */
+function historyValue(history, head, index) {
+	return history[(head + index) % history.length];
+}
+//#endregion
+export { DefaultManySink };
+
+//# sourceMappingURL=many.js.map

package/dist/sinks/many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.js","names":[],"sources":["../../src/sinks/many.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport {AsyncQueue} from \"@/internal/async-queue.js\";\nimport {Flux} from \"@/publisher/flux.js\";\nimport type {PublisherInput} from \"@/publisher/types.js\";\nimport {SignalType} from \"@/signal/signal-type.js\";\nimport {\n    addSinkSubscriber,\n    clearSinkSubscribers,\n    removeSinkSubscriber,\n    sinkSubscriberCount,\n    type SinkSubscribers\n} from \"@/sinks/subscribers.js\";\nimport {type EmitFailureHandler, EmitFailureHandlers, emitOrThrow, EmitResult, type ManySink} from \"@/sinks/types.js\";\n\n/** Delivery mode supported by the default many-valued sink. */\ntype ManyMode = \"unicast\" | \"unicast-error\" | \"multicast-buffer\" | \"multicast-direct\" | \"replay\";\n\n/** Configuration for a many-valued sink implementation. */\nexport interface ManyOptions<T> {\n    /** Delivery mode used by the sink. */\n    mode: ManyMode;\n    /** Maximum number of replayed values retained in history. */\n    replayLimit?: number;\n    /** Initial value replayed by latest-or-default sinks. */\n    latestDefault?: T;\n}\n\n/** Default implementation for unicast, multicast and replay many-valued sinks. */\nexport class DefaultManySink<T> implements ManySink<T> {\n    /** Active subscriber queues currently receiving live values. */\n    private subscribers: SinkSubscribers<T> | undefined;\n    /** Values buffered before a non-replay sink receives its first subscriber. */\n    private pending: T[] | undefined;\n    /** Values retained for replay subscribers. */\n    private history: T[] | undefined;\n    /** Ring-buffer index of the oldest replay value. */\n    private historyHead = 0;\n    /** Terminal state when the sink has completed or failed. */\n    private terminated: \"complete\" | \"error\" | undefined;\n    /** Error retained for late subscribers after failure. */\n    private errorValue: unknown;\n    /** Tracks whether a unicast sink already accepted its single subscriber. */\n    private unicastAttached = false;\n    /** Construction options controlling delivery and replay behavior. */\n    private readonly options: ManyOptions<T>;\n\n    /** Creates a many-valued sink with the provided delivery mode. */\n    public constructor(options: ManyOptions<T>) {\n        this.options = options;\n        if (options.latestDefault !== undefined) {\n            this.rememberHistory(options.latestDefault);\n        }\n    }\n\n    /** Returns the Flux view of this sink. */\n    public asFlux(): Flux<T> {\n        return new Flux(signal => {\n            const queue = new AsyncQueue<T>(signal);\n            if (isUnicast(this.options.mode) && this.unicastAttached) {\n                queue.error(new Error(\"Unicast sink allows only one subscriber\"));\n                return queue;\n            }\n            if (isUnicast(this.options.mode)) {\n                this.unicastAttached = true;\n            }\n            const history = this.history;\n            if (history) {\n                for (let index = 0; index < history.length; index += 1) {\n                    queue.push(historyValue(history, this.historyHead, index));\n                }\n            }\n            if (this.pending && this.pending.length > 0) {\n                const pending = this.pending;\n                this.pending = undefined;\n                for (const value of pending) {\n                    queue.push(value);\n                }\n            }\n            if (this.terminated === \"complete\") {\n                queue.complete();\n            } else if (this.terminated === \"error\") {\n                queue.error(this.errorValue);\n            } else {\n                this.addSubscriber(queue, signal);\n            }\n            return queue;\n        });\n    }\n\n    /** Attempts to emit a value to current subscribers. */\n    public tryEmitNext(value: T): EmitResult {\n        if (this.terminated) {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        if (this.options.mode === \"replay\") {\n            this.rememberHistory(value);\n        }\n        const subscribers = this.subscribers;\n        if (!subscribers) {\n            if (this.options.mode === \"multicast-direct\" || this.options.mode === \"unicast-error\") {\n                return EmitResult.FAIL_ZERO_SUBSCRIBER;\n            }\n            if (this.options.mode !== \"replay\") {\n                (this.pending ??= []).push(value);\n            }\n            return EmitResult.OK;\n        }\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.push(value);\n            }\n        } else {\n            subscribers.push(value);\n        }\n        return EmitResult.OK;\n    }\n\n    /** Attempts to complete this sink. */\n    public tryEmitComplete(): EmitResult {\n        if (this.terminated) {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        const subscribers = this.subscribers;\n        if (this.options.mode === \"unicast-error\" && !subscribers) {\n            return EmitResult.FAIL_ZERO_SUBSCRIBER;\n        }\n        this.terminated = \"complete\";\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.complete();\n            }\n        } else if (subscribers) {\n            subscribers.complete();\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Attempts to fail this sink. */\n    public tryEmitError(error: unknown): EmitResult {\n        if (this.terminated) {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        const subscribers = this.subscribers;\n        if (this.options.mode === \"unicast-error\" && !subscribers) {\n            return EmitResult.FAIL_ZERO_SUBSCRIBER;\n        }\n        this.terminated = \"error\";\n        this.errorValue = error;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.error(error);\n            }\n        } else if (subscribers) {\n            subscribers.error(error);\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Emits a value or delegates failure handling to the provided handler. */\n    public emitNext(value: T, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        emitOrThrow(SignalType.NEXT, () => this.tryEmitNext(value), handler);\n    }\n\n    /** Completes this sink or delegates failure handling to the provided handler. */\n    public emitComplete(handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        emitOrThrow(SignalType.COMPLETE, () => this.tryEmitComplete(), handler);\n    }\n\n    /** Fails this sink or delegates failure handling to the provided handler. */\n    public emitError(error: unknown, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        emitOrThrow(SignalType.ERROR, () => this.tryEmitError(error), handler, error);\n    }\n\n    /** Returns the current number of active subscribers. */\n    public currentSubscriberCount(): number {\n        return sinkSubscriberCount(this.subscribers);\n    }\n\n    /** Subscribes this sink to an upstream publisher and relays its signals. */\n    public subscribeTo(source: PublisherInput<T>): void {\n        Flux.from(source).subscribe(\n            value => this.emitNext(value),\n            error => this.emitError(error),\n            () => this.emitComplete()\n        );\n    }\n\n    /** Handles an emission failure and returns false to fail fast by default. */\n    public onEmitFailure(_signalType: SignalType, _emitResult: EmitResult): boolean {\n        return false;\n    }\n\n    /** Adds a subscriber queue and removes it again when its subscription is cancelled. */\n    private addSubscriber(queue: AsyncQueue<T>, signal: AbortSignal): void {\n        this.subscribers = addSinkSubscriber(this.subscribers, queue);\n        signal.addEventListener(\"abort\", () => this.removeSubscriber(queue), {once: true});\n    }\n\n    /** Removes a subscriber queue and releases the set when it becomes empty. */\n    private removeSubscriber(queue: AsyncQueue<T>): void {\n        this.subscribers = removeSinkSubscriber(this.subscribers, queue);\n    }\n\n    /** Clears and releases all active subscriber queues. */\n    private clearSubscribers(): void {\n        clearSinkSubscribers(this.subscribers);\n        this.subscribers = undefined;\n    }\n\n    /** Records one value into replay history, allocating history only for replay sinks. */\n    private rememberHistory(value: T): void {\n        const limit = this.options.replayLimit ?? Number.POSITIVE_INFINITY;\n        if (limit <= 0) {\n            return;\n        }\n        const history = this.history;\n        if (!history) {\n            this.history = [value];\n            this.historyHead = 0;\n            return;\n        }\n        if (history.length < limit) {\n            history.push(value);\n            return;\n        }\n        history[this.historyHead] = value;\n        this.historyHead = (this.historyHead + 1) % history.length;\n    }\n}\n\n/** Returns true for sink modes that allow exactly one subscriber. */\nfunction isUnicast(mode: ManyMode): boolean {\n    return mode === \"unicast\" || mode === \"unicast-error\";\n}\n\n/** Returns a replay history value in oldest-to-newest order. */\nfunction historyValue<T>(history: T[], head: number, index: number): T {\n    return history[(head + index) % history.length] as T;\n}\n"],"mappings":"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"}

package/dist/sinks/one.d.ts

@@ -0,0 +1,41 @@
+import { Mono } from "../publisher/mono.js";
+import { SignalType } from "../signal/signal-type.js";
+import { type EmitFailureHandler, EmitResult, type OneSink } from "./types.js";
+/** Default replaying implementation for `Sinks.one()` and `Sinks.empty()`. */
+export declare class DefaultOneSink<T> implements OneSink<T> {
+    /** Current terminal or pending state of the sink. */
+    private state;
+    /** Stored value replayed to late subscribers after successful termination. */
+    private value;
+    /** Stored error replayed to late subscribers after failed termination. */
+    private errorValue;
+    /** Active subscriber queues waiting for the terminal result, created only when needed. */
+    private subscribers;
+    /** Returns the Mono view of this sink. */
+    asMono(): Mono<T>;
+    /** Attempts to emit a value and complete this sink. */
+    tryEmitValue(value: T): EmitResult;
+    /** Attempts to complete this sink without a value. */
+    tryEmitEmpty(): EmitResult;
+    /** Attempts to fail this sink. */
+    tryEmitError(error: unknown): EmitResult;
+    /** Emits a value or delegates failure handling to the provided handler. */
+    emitValue(value: T, handler?: EmitFailureHandler): void;
+    /** Completes this sink or delegates failure handling to the provided handler. */
+    emitEmpty(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;
+    /** 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;
+    /** Replays the current state into a newly subscribed queue. */
+    private replay;
+}
+//# sourceMappingURL=one.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"one.d.ts","sourceRoot":"","sources":["../../src/sinks/one.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AAQnD,OAAO,EAAC,KAAK,kBAAkB,EAAoC,UAAU,EAAE,KAAK,OAAO,EAAC,MAAM,kBAAkB,CAAC;AAKrH,8EAA8E;AAC9E,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAChD,qDAAqD;IACrD,OAAO,CAAC,KAAK,CAAuB;IACpC,8EAA8E;IAC9E,OAAO,CAAC,KAAK,CAAgB;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAAU;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,WAAW,CAAiC;IAEpD,0CAA0C;IACnC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CASvB;IAED,uDAAuD;IAChD,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAkBxC;IAED,sDAAsD;IAC/C,YAAY,IAAI,UAAU,CAehC;IAED,kCAAkC;IAC3B,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAgB9C;IAED,2EAA2E;IACpE,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAK5F;IAED,iFAAiF;IAC1E,SAAS,CAAC,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAKlF;IAED,6EAA6E;IACtE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAkD,GAAG,IAAI,CAKlG;IAED,wDAAwD;IACjD,sBAAsB,IAAI,MAAM,CAEtC;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,+DAA+D;IAC/D,OAAO,CAAC,MAAM;CAgBjB"}

package/dist/sinks/one.js

@@ -0,0 +1,144 @@
+import _defineProperty from "../_virtual/_@oxc-project_runtime@0.139.0/helpers/esm/defineProperty.js";
+import { AsyncQueue } from "../internal/async-queue.js";
+import { SignalType } from "../signal/signal-type.js";
+import { Mono } from "../publisher/mono.js";
+import { addSinkSubscriber, clearSinkSubscribers, removeSinkSubscriber, sinkSubscriberCount } from "./subscribers.js";
+import { EmitFailureHandlers, EmitResult, emitOrThrow } from "./types.js";
+//#region src/sinks/one.ts
+/**
+* @packageDocumentation
+* Sink specifications and default browser-oriented sink implementations.
+*/
+/** Default replaying implementation for `Sinks.one()` and `Sinks.empty()`. */
+var DefaultOneSink = class {
+	constructor() {
+		_defineProperty(
+			this,
+			/** Current terminal or pending state of the sink. */
+			"state",
+			"pending"
+		);
+		_defineProperty(
+			this,
+			/** Stored value replayed to late subscribers after successful termination. */
+			"value",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Stored error replayed to late subscribers after failed termination. */
+			"errorValue",
+			void 0
+		);
+		_defineProperty(
+			this,
+			/** Active subscriber queues waiting for the terminal result, created only when needed. */
+			"subscribers",
+			void 0
+		);
+	}
+	/** Returns the Mono view of this sink. */
+	asMono() {
+		return new Mono((signal) => {
+			const queue = new AsyncQueue(signal);
+			this.replay(queue);
+			if (this.state === "pending") this.addSubscriber(queue, signal);
+			return queue;
+		});
+	}
+	/** Attempts to emit a value and complete this sink. */
+	tryEmitValue(value) {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "value";
+		this.value = value;
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) {
+			subscriber.push(value);
+			subscriber.complete();
+		}
+		else if (subscribers) {
+			subscribers.push(value);
+			subscribers.complete();
+		}
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Attempts to complete this sink without a value. */
+	tryEmitEmpty() {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "empty";
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.complete();
+		else if (subscribers) subscribers.complete();
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Attempts to fail this sink. */
+	tryEmitError(error) {
+		if (this.state !== "pending") return EmitResult.FAIL_TERMINATED;
+		this.state = "error";
+		this.errorValue = error;
+		const subscribers = this.subscribers;
+		if (subscribers instanceof Set) for (const subscriber of subscribers) subscriber.error(error);
+		else if (subscribers) subscribers.error(error);
+		this.clearSubscribers();
+		return EmitResult.OK;
+	}
+	/** Emits a value or delegates failure handling to the provided handler. */
+	emitValue(value, handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitValue(value);
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.NEXT, () => result, handler);
+	}
+	/** Completes this sink or delegates failure handling to the provided handler. */
+	emitEmpty(handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitEmpty();
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.COMPLETE, () => result, handler);
+	}
+	/** Fails this sink or delegates failure handling to the provided handler. */
+	emitError(error, handler = EmitFailureHandlers.FAIL_FAST) {
+		const result = this.tryEmitError(error);
+		if (result !== EmitResult.FAIL_TERMINATED) emitOrThrow(SignalType.ERROR, () => result, handler, error);
+	}
+	/** Returns the current number of active subscribers. */
+	currentSubscriberCount() {
+		return sinkSubscriberCount(this.subscribers);
+	}
+	/** Handles an emission failure and returns false to fail fast by default. */
+	onEmitFailure(_signalType, _emitResult) {
+		return false;
+	}
+	/** Adds a subscriber queue and removes it again when its subscription is cancelled. */
+	addSubscriber(queue, signal) {
+		this.subscribers = addSinkSubscriber(this.subscribers, queue);
+		signal.addEventListener("abort", () => this.removeSubscriber(queue), { once: true });
+	}
+	/** Removes a subscriber queue and releases the set when it becomes empty. */
+	removeSubscriber(queue) {
+		this.subscribers = removeSinkSubscriber(this.subscribers, queue);
+	}
+	/** Clears and releases all active subscriber queues. */
+	clearSubscribers() {
+		clearSinkSubscribers(this.subscribers);
+		this.subscribers = void 0;
+	}
+	/** Replays the current state into a newly subscribed queue. */
+	replay(queue) {
+		switch (this.state) {
+			case "value":
+				queue.push(this.value);
+				queue.complete();
+				break;
+			case "empty":
+				queue.complete();
+				break;
+			case "error":
+				queue.error(this.errorValue);
+				break;
+			case "pending": break;
+		}
+	}
+};
+//#endregion
+export { DefaultOneSink };
+
+//# sourceMappingURL=one.js.map

package/dist/sinks/one.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one.js","names":[],"sources":["../../src/sinks/one.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport {AsyncQueue} from \"@/internal/async-queue.js\";\nimport {Mono} from \"@/publisher/mono.js\";\nimport {SignalType} from \"@/signal/signal-type.js\";\nimport {\n    addSinkSubscriber,\n    clearSinkSubscribers,\n    removeSinkSubscriber,\n    sinkSubscriberCount,\n    type SinkSubscribers\n} from \"@/sinks/subscribers.js\";\nimport {type EmitFailureHandler, EmitFailureHandlers, emitOrThrow, EmitResult, type OneSink} from \"@/sinks/types.js\";\n\n/** Terminal or pending state held by a one-valued sink. */\ntype OneState = \"pending\" | \"empty\" | \"value\" | \"error\";\n\n/** Default replaying implementation for `Sinks.one()` and `Sinks.empty()`. */\nexport class DefaultOneSink<T> implements OneSink<T> {\n    /** Current terminal or pending state of the sink. */\n    private state: OneState = \"pending\";\n    /** Stored value replayed to late subscribers after successful termination. */\n    private value: T | undefined;\n    /** Stored error replayed to late subscribers after failed termination. */\n    private errorValue: unknown;\n    /** Active subscriber queues waiting for the terminal result, created only when needed. */\n    private subscribers: SinkSubscribers<T> | undefined;\n\n    /** Returns the Mono view of this sink. */\n    public asMono(): Mono<T> {\n        return new Mono(signal => {\n            const queue = new AsyncQueue<T>(signal);\n            this.replay(queue);\n            if (this.state === \"pending\") {\n                this.addSubscriber(queue, signal);\n            }\n            return queue;\n        });\n    }\n\n    /** Attempts to emit a value and complete this sink. */\n    public tryEmitValue(value: T): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"value\";\n        this.value = value;\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.push(value);\n                subscriber.complete();\n            }\n        } else if (subscribers) {\n            subscribers.push(value);\n            subscribers.complete();\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Attempts to complete this sink without a value. */\n    public tryEmitEmpty(): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"empty\";\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.complete();\n            }\n        } else if (subscribers) {\n            subscribers.complete();\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Attempts to fail this sink. */\n    public tryEmitError(error: unknown): EmitResult {\n        if (this.state !== \"pending\") {\n            return EmitResult.FAIL_TERMINATED;\n        }\n        this.state = \"error\";\n        this.errorValue = error;\n        const subscribers = this.subscribers;\n        if (subscribers instanceof Set) {\n            for (const subscriber of subscribers) {\n                subscriber.error(error);\n            }\n        } else if (subscribers) {\n            subscribers.error(error);\n        }\n        this.clearSubscribers();\n        return EmitResult.OK;\n    }\n\n    /** Emits a value or delegates failure handling to the provided handler. */\n    public emitValue(value: T, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitValue(value);\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.NEXT, () => result, handler);\n        }\n    }\n\n    /** Completes this sink or delegates failure handling to the provided handler. */\n    public emitEmpty(handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitEmpty();\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.COMPLETE, () => result, handler);\n        }\n    }\n\n    /** Fails this sink or delegates failure handling to the provided handler. */\n    public emitError(error: unknown, handler: EmitFailureHandler = EmitFailureHandlers.FAIL_FAST): void {\n        const result = this.tryEmitError(error);\n        if (result !== EmitResult.FAIL_TERMINATED) {\n            emitOrThrow(SignalType.ERROR, () => result, handler, error);\n        }\n    }\n\n    /** Returns the current number of active subscribers. */\n    public currentSubscriberCount(): number {\n        return sinkSubscriberCount(this.subscribers);\n    }\n\n    /** Handles an emission failure and returns false to fail fast by default. */\n    public onEmitFailure(_signalType: SignalType, _emitResult: EmitResult): boolean {\n        return false;\n    }\n\n    /** Adds a subscriber queue and removes it again when its subscription is cancelled. */\n    private addSubscriber(queue: AsyncQueue<T>, signal: AbortSignal): void {\n        this.subscribers = addSinkSubscriber(this.subscribers, queue);\n        signal.addEventListener(\"abort\", () => this.removeSubscriber(queue), {once: true});\n    }\n\n    /** Removes a subscriber queue and releases the set when it becomes empty. */\n    private removeSubscriber(queue: AsyncQueue<T>): void {\n        this.subscribers = removeSinkSubscriber(this.subscribers, queue);\n    }\n\n    /** Clears and releases all active subscriber queues. */\n    private clearSubscribers(): void {\n        clearSinkSubscribers(this.subscribers);\n        this.subscribers = undefined;\n    }\n\n    /** Replays the current state into a newly subscribed queue. */\n    private replay(queue: AsyncQueue<T>): void {\n        switch (this.state) {\n            case \"value\":\n                queue.push(this.value as T);\n                queue.complete();\n                break;\n            case \"empty\":\n                queue.complete();\n                break;\n            case \"error\":\n                queue.error(this.errorValue);\n                break;\n            case \"pending\":\n                break;\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAa,iBAAb,MAAqD;;;;;GAEjD;GAA0B;;;;;GAE1B;;;;;;GAEA;;;;;;GAEA;;;;;CAGA,SAAyB;EACrB,OAAO,IAAI,MAAK,WAAU;GACtB,MAAM,QAAQ,IAAI,WAAc,MAAM;GACtC,KAAK,OAAO,KAAK;GACjB,IAAI,KAAK,UAAU,WACf,KAAK,cAAc,OAAO,MAAM;GAEpC,OAAO;EACX,CAAC;CACL;;CAGA,aAAoB,OAAsB;EACtC,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aAAa;GAClC,WAAW,KAAK,KAAK;GACrB,WAAW,SAAS;EACxB;OACG,IAAI,aAAa;GACpB,YAAY,KAAK,KAAK;GACtB,YAAY,SAAS;EACzB;EACA,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,eAAkC;EAC9B,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aACrB,WAAW,SAAS;OAErB,IAAI,aACP,YAAY,SAAS;EAEzB,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,aAAoB,OAA4B;EAC5C,IAAI,KAAK,UAAU,WACf,OAAO,WAAW;EAEtB,KAAK,QAAQ;EACb,KAAK,aAAa;EAClB,MAAM,cAAc,KAAK;EACzB,IAAI,uBAAuB,KACvB,KAAK,MAAM,cAAc,aACrB,WAAW,MAAM,KAAK;OAEvB,IAAI,aACP,YAAY,MAAM,KAAK;EAE3B,KAAK,iBAAiB;EACtB,OAAO,WAAW;CACtB;;CAGA,UAAiB,OAAU,UAA8B,oBAAoB,WAAiB;EAC1F,MAAM,SAAS,KAAK,aAAa,KAAK;EACtC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,YAAY,QAAQ,OAAO;CAE1D;;CAGA,UAAiB,UAA8B,oBAAoB,WAAiB;EAChF,MAAM,SAAS,KAAK,aAAa;EACjC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,gBAAgB,QAAQ,OAAO;CAE9D;;CAGA,UAAiB,OAAgB,UAA8B,oBAAoB,WAAiB;EAChG,MAAM,SAAS,KAAK,aAAa,KAAK;EACtC,IAAI,WAAW,WAAW,iBACtB,YAAY,WAAW,aAAa,QAAQ,SAAS,KAAK;CAElE;;CAGA,yBAAwC;EACpC,OAAO,oBAAoB,KAAK,WAAW;CAC/C;;CAGA,cAAqB,aAAyB,aAAkC;EAC5E,OAAO;CACX;;CAGA,cAAsB,OAAsB,QAA2B;EACnE,KAAK,cAAc,kBAAkB,KAAK,aAAa,KAAK;EAC5D,OAAO,iBAAiB,eAAe,KAAK,iBAAiB,KAAK,GAAG,EAAC,MAAM,KAAI,CAAC;CACrF;;CAGA,iBAAyB,OAA4B;EACjD,KAAK,cAAc,qBAAqB,KAAK,aAAa,KAAK;CACnE;;CAGA,mBAAiC;EAC7B,qBAAqB,KAAK,WAAW;EACrC,KAAK,cAAc;CACvB;;CAGA,OAAe,OAA4B;EACvC,QAAQ,KAAK,OAAb;GACI,KAAK;IACD,MAAM,KAAK,KAAK,KAAU;IAC1B,MAAM,SAAS;IACf;GACJ,KAAK;IACD,MAAM,SAAS;IACf;GACJ,KAAK;IACD,MAAM,MAAM,KAAK,UAAU;IAC3B;GACJ,KAAK,WACD;EACR;CACJ;AACJ"}

package/dist/sinks/specs.d.ts

@@ -0,0 +1,25 @@
+import type { EmptySink, ManySink, ManySpec, ManyWithUpstreamSpec, OneSink } from "./types.js";
+/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */
+declare const unsafeSpec: {
+    /** Creates an empty sink that can only terminate. */
+    empty<T>(): EmptySink<T>;
+    /** Creates a one-valued sink that replays its terminal result. */
+    one<T>(): OneSink<T>;
+    /** Returns builders for many-valued sinks. */
+    many(): ManySpec;
+    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */
+    manyWithUpstream(): ManyWithUpstreamSpec;
+};
+/** Public Sinks factory facade. */
+export declare const Sinks: Readonly<{
+    /** Creates an empty sink that can only terminate. */
+    empty<T>(): EmptySink<T>;
+    /** Creates a one-valued sink that replays its terminal result. */
+    one<T>(): OneSink<T>;
+    /** Returns builders for many-valued sinks. */
+    many(): ManySpec;
+    /** Returns unsafe sink builders. */
+    unsafe(): typeof unsafeSpec;
+}>;
+export type { ManySink };
+//# sourceMappingURL=specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/sinks/specs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,oBAAoB,EAEpB,OAAO,EAGR,MAAM,kBAAkB,CAAC;AAqF1B,+EAA+E;AAC/E,QAAA,MAAM,UAAU,EAAE;IACd,qDAAqD;IACrD,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,kEAAkE;IAClE,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,8CAA8C;IAC9C,IAAI,IAAI,QAAQ,CAAC;IACjB,2FAA2F;IAC3F,gBAAgB,IAAI,oBAAoB,CAAC;CAqB3C,CAAC;AAEH,mCAAmC;AACnC,eAAO,MAAM,KAAK;IACd,qDAAqD;UAC/C,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IAIxB,kEAAkE;QAC9D,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAIpB,8CAA8C;YACtC,QAAQ;IAIhB,oCAAoC;cAC1B,OAAO,UAAU;EAG7B,CAAC;AAEH,YAAY,EAAC,QAAQ,EAAC,CAAC"}

package/dist/sinks/specs.js

@@ -0,0 +1,126 @@
+import { DefaultManySink } from "./many.js";
+import { DefaultOneSink } from "./one.js";
+//#region src/sinks/specs.ts
+/**
+* @packageDocumentation
+* Sink specifications and default browser-oriented sink implementations.
+*/
+/** Shared builders for unicast many-valued sinks. */
+var unicastSpec = Object.freeze({
+	/** Creates a unicast sink with backpressure buffering. */
+	onBackpressureBuffer() {
+		return new DefaultManySink({ mode: "unicast" });
+	},
+	/** Creates a unicast sink that fails emission when demand cannot be honored. */
+	onBackpressureError() {
+		return new DefaultManySink({ mode: "unicast-error" });
+	}
+});
+/** Shared builders for multicast many-valued sinks. */
+var multicastSpec = Object.freeze({
+	/** Creates a multicast sink that buffers when subscribers are temporarily absent. */
+	onBackpressureBuffer() {
+		return new DefaultManySink({ mode: "multicast-buffer" });
+	},
+	/** Creates a multicast sink that fails emission when no subscriber can receive it. */
+	directAllOrNothing() {
+		return new DefaultManySink({ mode: "multicast-direct" });
+	},
+	/** Creates a multicast sink that emits to currently available subscribers. */
+	directBestEffort() {
+		return new DefaultManySink({ mode: "multicast-direct" });
+	}
+});
+/** Shared builders for replaying many-valued sinks. */
+var replaySpec = Object.freeze({
+	/** Creates a replay sink retaining every emitted value. */
+	all() {
+		return new DefaultManySink({ mode: "replay" });
+	},
+	/** Creates a replay sink retaining at most `historySize` values. */
+	limit(historySize) {
+		if (!Number.isInteger(historySize) || historySize <= 0) throw new RangeError("historySize must be a strictly positive integer");
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: historySize
+		});
+	},
+	/** Creates a replay sink retaining only the latest emitted value. */
+	latest() {
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: 1
+		});
+	},
+	/** Creates a replay sink with an initial default latest value. */
+	latestOrDefault(value) {
+		return new DefaultManySink({
+			mode: "replay",
+			replayLimit: 1,
+			latestDefault: value
+		});
+	}
+});
+/** Shared builder tree for many-valued sink variants. */
+var manySpec = Object.freeze({
+	/** Returns builders for unicast many-valued sinks. */
+	unicast() {
+		return unicastSpec;
+	},
+	/** Returns builders for multicast many-valued sinks. */
+	multicast() {
+		return multicastSpec;
+	},
+	/** Returns builders for replaying many-valued sinks. */
+	replay() {
+		return replaySpec;
+	}
+});
+/** Shared unsafe builders for many-valued sinks that subscribe to upstream publishers. */
+var manyWithUpstreamSpec = Object.freeze({ 
+/** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */
+multicastOnBackpressureBuffer() {
+	return new DefaultManySink({ mode: "multicast-buffer" });
+} });
+/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */
+var unsafeSpec = Object.freeze({
+	/** Creates an empty sink that can only terminate. */
+	empty() {
+		return new DefaultOneSink();
+	},
+	/** Creates a one-valued sink that replays its terminal result. */
+	one() {
+		return new DefaultOneSink();
+	},
+	/** Returns builders for many-valued sinks. */
+	many() {
+		return manySpec;
+	},
+	/** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */
+	manyWithUpstream() {
+		return manyWithUpstreamSpec;
+	}
+});
+/** Public Sinks factory facade. */
+var Sinks = Object.freeze({
+	/** Creates an empty sink that can only terminate. */
+	empty() {
+		return new DefaultOneSink();
+	},
+	/** Creates a one-valued sink that replays its terminal result. */
+	one() {
+		return new DefaultOneSink();
+	},
+	/** Returns builders for many-valued sinks. */
+	many() {
+		return manySpec;
+	},
+	/** Returns unsafe sink builders. */
+	unsafe() {
+		return unsafeSpec;
+	}
+});
+//#endregion
+export { Sinks };
+
+//# sourceMappingURL=specs.js.map

package/dist/sinks/specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.js","names":[],"sources":["../../src/sinks/specs.ts"],"sourcesContent":["/**\n * @packageDocumentation\n * Sink specifications and default browser-oriented sink implementations.\n */\nimport {DefaultManySink} from \"@/sinks/many.js\";\nimport {DefaultOneSink} from \"@/sinks/one.js\";\nimport type {\n  EmptySink,\n  ManySink,\n  ManySpec,\n  ManyWithUpstreamSpec,\n  MulticastSpec,\n  OneSink,\n  ReplaySpec,\n  UnicastSpec\n} from \"@/sinks/types.js\";\n\n/** Shared builders for unicast many-valued sinks. */\nconst unicastSpec: UnicastSpec = Object.freeze({\n    /** Creates a unicast sink with backpressure buffering. */\n    onBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"unicast\"});\n    },\n\n    /** Creates a unicast sink that fails emission when demand cannot be honored. */\n    onBackpressureError<T>() {\n        return new DefaultManySink<T>({mode: \"unicast-error\"});\n    }\n});\n\n/** Shared builders for multicast many-valued sinks. */\nconst multicastSpec: MulticastSpec = Object.freeze({\n    /** Creates a multicast sink that buffers when subscribers are temporarily absent. */\n    onBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-buffer\"});\n    },\n\n    /** Creates a multicast sink that fails emission when no subscriber can receive it. */\n    directAllOrNothing<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-direct\"});\n    },\n\n    /** Creates a multicast sink that emits to currently available subscribers. */\n    directBestEffort<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-direct\"});\n    }\n});\n\n/** Shared builders for replaying many-valued sinks. */\nconst replaySpec: ReplaySpec = Object.freeze({\n    /** Creates a replay sink retaining every emitted value. */\n    all<T>() {\n        return new DefaultManySink<T>({mode: \"replay\"});\n    },\n\n    /** Creates a replay sink retaining at most `historySize` values. */\n    limit<T>(historySize: number) {\n        if (!Number.isInteger(historySize) || historySize <= 0) {\n            throw new RangeError(\"historySize must be a strictly positive integer\");\n        }\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: historySize});\n    },\n\n    /** Creates a replay sink retaining only the latest emitted value. */\n    latest<T>() {\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: 1});\n    },\n\n    /** Creates a replay sink with an initial default latest value. */\n    latestOrDefault<T>(value: T) {\n        return new DefaultManySink<T>({mode: \"replay\", replayLimit: 1, latestDefault: value});\n    }\n});\n\n/** Shared builder tree for many-valued sink variants. */\nconst manySpec: ManySpec = Object.freeze({\n    /** Returns builders for unicast many-valued sinks. */\n    unicast(): UnicastSpec {\n        return unicastSpec;\n    },\n\n    /** Returns builders for multicast many-valued sinks. */\n    multicast(): MulticastSpec {\n        return multicastSpec;\n    },\n\n    /** Returns builders for replaying many-valued sinks. */\n    replay(): ReplaySpec {\n        return replaySpec;\n    }\n});\n\n/** Shared unsafe builders for many-valued sinks that subscribe to upstream publishers. */\nconst manyWithUpstreamSpec: ManyWithUpstreamSpec = Object.freeze({\n    /** Creates a multicast sink that buffers and can subscribe to one upstream publisher. */\n    multicastOnBackpressureBuffer<T>() {\n        return new DefaultManySink<T>({mode: \"multicast-buffer\"});\n    }\n});\n\n/** Builder tree for unsafe sinks that can subscribe to upstream publishers. */\nconst unsafeSpec: {\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T>;\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T>;\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec;\n    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */\n    manyWithUpstream(): ManyWithUpstreamSpec;\n} = Object.freeze({\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec {\n        return manySpec;\n    },\n\n    /** Returns builders for many-valued sinks that can subscribe to one upstream publisher. */\n    manyWithUpstream(): ManyWithUpstreamSpec {\n        return manyWithUpstreamSpec;\n    }\n});\n\n/** Public Sinks factory facade. */\nexport const Sinks = Object.freeze({\n    /** Creates an empty sink that can only terminate. */\n    empty<T>(): EmptySink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Creates a one-valued sink that replays its terminal result. */\n    one<T>(): OneSink<T> {\n        return new DefaultOneSink<T>();\n    },\n\n    /** Returns builders for many-valued sinks. */\n    many(): ManySpec {\n        return manySpec;\n    },\n\n    /** Returns unsafe sink builders. */\n    unsafe(): typeof unsafeSpec {\n        return unsafeSpec;\n    }\n});\n\nexport type {ManySink};\n"],"mappings":";;;;;;;;AAkBA,IAAM,cAA2B,OAAO,OAAO;;CAE3C,uBAA0B;EACtB,OAAO,IAAI,gBAAmB,EAAC,MAAM,UAAS,CAAC;CACnD;;CAGA,sBAAyB;EACrB,OAAO,IAAI,gBAAmB,EAAC,MAAM,gBAAe,CAAC;CACzD;AACJ,CAAC;;AAGD,IAAM,gBAA+B,OAAO,OAAO;;CAE/C,uBAA0B;EACtB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;;CAGA,qBAAwB;EACpB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;;CAGA,mBAAsB;EAClB,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;CAC5D;AACJ,CAAC;;AAGD,IAAM,aAAyB,OAAO,OAAO;;CAEzC,MAAS;EACL,OAAO,IAAI,gBAAmB,EAAC,MAAM,SAAQ,CAAC;CAClD;;CAGA,MAAS,aAAqB;EAC1B,IAAI,CAAC,OAAO,UAAU,WAAW,KAAK,eAAe,GACjD,MAAM,IAAI,WAAW,iDAAiD;EAE1E,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;EAAW,CAAC;CAC5E;;CAGA,SAAY;EACR,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;EAAC,CAAC;CAClE;;CAGA,gBAAmB,OAAU;EACzB,OAAO,IAAI,gBAAmB;GAAC,MAAM;GAAU,aAAa;GAAG,eAAe;EAAK,CAAC;CACxF;AACJ,CAAC;;AAGD,IAAM,WAAqB,OAAO,OAAO;;CAErC,UAAuB;EACnB,OAAO;CACX;;CAGA,YAA2B;EACvB,OAAO;CACX;;CAGA,SAAqB;EACjB,OAAO;CACX;AACJ,CAAC;;AAGD,IAAM,uBAA6C,OAAO,OAAO;;AAE7D,gCAAmC;CAC/B,OAAO,IAAI,gBAAmB,EAAC,MAAM,mBAAkB,CAAC;AAC5D,EACJ,CAAC;;AAGD,IAAM,aASF,OAAO,OAAO;;CAEd,QAAyB;EACrB,OAAO,IAAI,eAAkB;CACjC;;CAGA,MAAqB;EACjB,OAAO,IAAI,eAAkB;CACjC;;CAGA,OAAiB;EACb,OAAO;CACX;;CAGA,mBAAyC;EACrC,OAAO;CACX;AACJ,CAAC;;AAGD,IAAa,QAAQ,OAAO,OAAO;;CAE/B,QAAyB;EACrB,OAAO,IAAI,eAAkB;CACjC;;CAGA,MAAqB;EACjB,OAAO,IAAI,eAAkB;CACjC;;CAGA,OAAiB;EACb,OAAO;CACX;;CAGA,SAA4B;EACxB,OAAO;CACX;AACJ,CAAC"}

package/dist/sinks/subscribers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @packageDocumentation
+ * Compact subscriber storage shared by sink implementations.
+ */
+import type { AsyncQueue } from "../internal/async-queue.js";
+/** Compact storage for one or many active sink subscriber queues. */
+export type SinkSubscribers<T> = AsyncQueue<T> | Set<AsyncQueue<T>>;
+/** Adds a queue without allocating a Set for the common single-subscriber case. */
+export declare function addSinkSubscriber<T>(subscribers: SinkSubscribers<T> | undefined, queue: AsyncQueue<T>): SinkSubscribers<T>;
+/** Removes a queue and releases multi-subscriber storage when it becomes empty. */
+export declare function removeSinkSubscriber<T>(subscribers: SinkSubscribers<T> | undefined, queue: AsyncQueue<T>): SinkSubscribers<T> | undefined;
+/** Clears multi-subscriber storage before the owner drops its reference. */
+export declare function clearSinkSubscribers<T>(subscribers: SinkSubscribers<T> | undefined): void;
+/** Returns the number of active queues in compact subscriber storage. */
+export declare function sinkSubscriberCount<T>(subscribers: SinkSubscribers<T> | undefined): number;
+//# sourceMappingURL=subscribers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/sinks/subscribers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAE1D,qEAAqE;AACrE,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,CAAC,EAC/B,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,CASpB;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAShC;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAIzF;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,CAK1F"}