@davidcal/frosth 1.5.0 → 1.6.1

package/README.md

@@ -1,6 +1,6 @@
 # Frosth - Yet another UI framework
 
-**Latest version**: v1.5.0
+**Latest version**: v1.6.1
 
 ## Motivation
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@davidcal/frosth",
-	"version": "1.5.0",
+	"version": "1.6.1",
 	"description": "Async-first CRUD-last UI framework that treats encapsulation as a solved problem.",
 	"type": "module",
 	"main": "./src/sigew.js",

package/src/create_producer.js

@@ -0,0 +1,37 @@
+export const create_producer = () => {
+	const result = {};
+	
+	const subscriptions = new Set();
+	
+	const create_stream = () => {
+		const result = {};	
+		
+		result.subscribe = (handler) => {
+			subscriptions.add(handler);
+			
+			const unsubscribe = () => {
+				subscriptions.delete(handler);
+			};
+			
+			return { unsubscribe };
+		};
+		
+		return result;
+	};
+	
+	result.emit = (message) => {
+		return result.emit_many([message]);
+	};
+	
+	result.emit_many = (messages) => {
+		for (const message of messages) {
+			for (const handler of subscriptions) {
+				handler(message);
+			}
+		}
+	};
+	
+	result.stream = create_stream();
+	
+	return result;
+};

package/src/create_self.js

@@ -25,6 +25,10 @@ class Self {
 		return create_self(this, run_effect, options);
 	}
 	
+	_is_effectfully_useful() {
+		return this._run_effect !== undefined;
+	}
+	
 	create_effect(callback) {
 		let child;
 		

package/src/create_wrapper_stream.js

@@ -0,0 +1,34 @@
+export const create_wrapper_stream = (stream, handle) => {
+	const result = {};
+
+	const subscriptions = new Set();
+
+	let upstream;
+
+	result.subscribe = (handler) => {
+		subscriptions.add(handler);
+
+		if (upstream === undefined) {
+			upstream = stream.subscribe((calldata) => {
+				handle(calldata, (new_calldata) => {
+					for (const handler of subscriptions) {
+						handler(new_calldata);
+					}
+				});
+			});
+		}
+
+		const unsubscribe = () => {
+			if (subscriptions.size === 1) {
+				upstream.unsubscribe();
+				upstream = undefined;
+			}
+
+			subscriptions.delete(handler);
+		};
+
+		return { unsubscribe };
+	};
+
+	return result;
+};

package/src/sigew.js

@@ -8,6 +8,11 @@ import { MARK_INSTALLABLE } from "./constants.js";
 import { create_memo } from "./create_memo.js";
 import { create_beacon } from "./create_beacon.js";
 import { create_stream } from "./create_stream.js";
+import { create_producer } from "./create_producer.js";
+import { stream_filter } from "./stream_filter.js";
+import { stream_map } from "./stream_map.js";
+import { stream_reduce } from "./stream_reduce.js";
+import { stream_latest } from "./stream_latest.js";
 
 export { create_self };
 export { create_signal };
@@ -15,6 +20,11 @@ export { h };
 export { create_memo };
 export { create_beacon };
 export { create_stream };
+export { create_producer };
+export { stream_filter };
+export { stream_map };
+export { stream_reduce };
+export { stream_latest };
 
 export const installarea = (s) => {
 	const storage = s.create_housed_signal(() => undefined);

package/src/stream_filter.js

@@ -0,0 +1,9 @@
+import { create_wrapper_stream } from "./create_wrapper_stream.js";
+
+export const stream_filter = (stream, predicate) =>
+	create_wrapper_stream(stream, (calldata, emit) => {
+		if (predicate(calldata)) {
+			emit(calldata);
+		}
+	})
+;

package/src/stream_latest.js

@@ -0,0 +1,41 @@
+import { create_signal } from "./create_signal.js";
+
+export const stream_latest = (stream, initial) => {
+	const signal = create_signal(() => initial);
+
+	let upstream = undefined;
+	const registered = new Set();
+
+	const consider_acquiring = () => {
+		if (upstream !== undefined) {
+			return;
+		}
+		
+		upstream = stream.subscribe((calldata) => {
+			signal.set(() => calldata);
+		});
+	};
+
+	const consider_releasing = () => {
+		if (registered.size !== 0) {
+			return;
+		}
+		
+		upstream.unsubscribe();
+		upstream = undefined;
+	};
+
+	return (self) => {
+		if (self._is_effectfully_useful() && !registered.has(self)) {
+			registered.add(self);
+			consider_acquiring();
+			
+			self.on_dispose(() => {
+				registered.delete(self);
+				consider_releasing();
+			});
+		}
+
+		return signal(self);
+	};
+};

package/src/stream_map.js

@@ -0,0 +1,7 @@
+import { create_wrapper_stream } from "./create_wrapper_stream.js";
+
+export const stream_map = (stream, mapper) =>
+	create_wrapper_stream(stream, (calldata, emit) => {
+		emit(mapper(calldata));
+	})
+;

package/src/stream_reduce.js

@@ -0,0 +1,10 @@
+import { create_wrapper_stream } from "./create_wrapper_stream.js";
+
+export const stream_reduce = (stream, reducer, initial) => {
+	let acc = initial;
+
+	return create_wrapper_stream(stream, (calldata, emit) => {
+		acc = reducer(acc, calldata);
+		emit(acc);
+	});
+};