@xtia/jel 0.7.2 → 0.8.0

package/index.d.ts

@@ -1,6 +1,7 @@
 export { DomEntity, ElementClassDescriptor, ElementDescriptor, DOMContent, DomHelper, StyleAccessor, JelEntity } from "./internal/types";
 import { $ } from "./internal/element";
+import { DomEntity } from "./internal/types";
 export { createEntity } from "./internal/util";
-export { createEventSource, interval, timeout, SubjectEmitter, toEventEmitter } from "./internal/emitter";
+export { createEventSource, interval, timeout, SubjectEmitter, toEventEmitter, type EventEmitter, combineEmitters } from "./internal/emitter";
 export { $ };
-export declare const $body: import(".").DomEntity<HTMLElement>;
+export declare const $body: DomEntity<HTMLElement>;

package/index.js

@@ -1,5 +1,5 @@
 import { $ } from "./internal/element";
 export { createEntity } from "./internal/util";
-export { createEventSource, interval, timeout, SubjectEmitter, toEventEmitter } from "./internal/emitter";
+export { createEventSource, interval, timeout, SubjectEmitter, toEventEmitter, combineEmitters } from "./internal/emitter";
 export { $ };
-export const $body = $(document.body);
+export const $body = "document" in globalThis ? $(document.body) : undefined;

package/internal/emitter.d.ts

@@ -121,6 +121,9 @@ export declare class EventEmitter<T> {
      */
     or(...emitters: EmitterLike<T>[]): EventEmitter<T>;
     or<U>(...emitters: EmitterLike<U>[]): EventEmitter<T | U>;
+    memo(): Memo<T | undefined>;
+    memo(initial: T): Memo<T>;
+    memo<U>(initial: U): Memo<T | U>;
 }
 /**
  * Creates a linked EventEmitter and emit() pair
@@ -157,16 +160,19 @@ export declare function createEventSource<T>(initialHandler?: Handler<T>): {
     emit: (value: T) => void;
     emitter: EventEmitter<T>;
 };
-export declare function createListenable<T>(sourceListen?: () => UnsubscribeFunc | undefined): {
-    listen: (fn: (v: T) => void) => UnsubscribeFunc;
-    emit: (value: T) => void;
-};
 export declare function interval(ms: number | {
     asMilliseconds: number;
 }): EventEmitter<number>;
 export declare function timeout(t: number | {
     asMilliseconds: number;
 }): EventEmitter<void>;
+declare class Memo<T> {
+    private _value;
+    private unsubscribeFunc;
+    get value(): T;
+    constructor(source: EmitterLike<T>, initial: T);
+    dispose(): void;
+}
 export declare class SubjectEmitter<T> extends EventEmitter<T> {
     private emit;
     private _value;
@@ -192,4 +198,13 @@ type EventSource<T, E extends string> = {
  */
 export declare function toEventEmitter<T>(source: EmitterLike<T>): EventEmitter<T>;
 export declare function toEventEmitter<T, E extends string>(source: EventSource<T, E>, eventName: E): EventEmitter<T>;
+type Dictionary<T> = Record<string | symbol, T>;
+type ExtractEmitterValue<T> = T extends EmitterLike<infer U> ? U : never;
+type CombinedRecord<T extends Dictionary<EmitterLike<any>>> = {
+    readonly [K in keyof T]: ExtractEmitterValue<T[K]>;
+};
+export declare function combineEmitters<U extends Dictionary<EmitterLike<any>>>(emitters: U): EventEmitter<CombinedRecord<U>>;
+export declare function combineEmitters<U extends EmitterLike<any>[]>(emitters: [...U]): EventEmitter<{
+    [K in keyof U]: ExtractEmitterValue<U[K]>;
+}>;
 export {};

package/internal/emitter.js

@@ -314,6 +314,9 @@ export class EventEmitter {
             return () => unsubs.forEach(unsub => unsub());
         });
     }
+    memo(initial) {
+        return new Memo(this, initial);
+    }
 }
 /**
  * Creates a linked EventEmitter and emit() pair
@@ -355,7 +358,7 @@ export function createEventSource(initialHandler) {
         emitter: new EventEmitter(listen)
     };
 }
-export function createListenable(sourceListen) {
+function createListenable(sourceListen) {
     const handlers = [];
     let onRemoveLast;
     const addListener = (fn) => {
@@ -401,6 +404,22 @@ export function timeout(t) {
     });
     return new EventEmitter(listen);
 }
+class Memo {
+    get value() {
+        return this._value;
+    }
+    constructor(source, initial) {
+        this._value = initial;
+        const emitter = toEventEmitter(source);
+        this.unsubscribeFunc = emitter.listen(v => this._value = v);
+    }
+    dispose() {
+        this.unsubscribeFunc();
+        this.unsubscribeFunc = () => {
+            throw new Error("Memo object already disposed");
+        };
+    }
+}
 export class SubjectEmitter extends EventEmitter {
     constructor(initial) {
         const { emit, listen } = createListenable();
@@ -456,3 +475,39 @@ export function toEventEmitter(source, eventName) {
     }
     throw new Error("Invalid event source");
 }
+function combineArray(emitters) {
+    let values = Array.from({ length: emitters.length });
+    const { emit, listen } = createListenable(() => {
+        const unsubFuncs = emitters.map((emitter, idx) => {
+            return emitter.listen(v => {
+                values[idx] = { value: v };
+                if (values.every(v => v !== undefined))
+                    emit(values.map(vc => vc.value));
+            });
+        });
+        return () => unsubFuncs.forEach(f => f());
+    });
+    return new EventEmitter(listen);
+}
+function combineRecord(emitters) {
+    const keys = Object.keys(emitters);
+    let values = {};
+    const { emit, listen } = createListenable(() => {
+        const unsubFuncs = keys.map(key => {
+            return emitters[key].listen(v => {
+                values[key] = { value: v };
+                if (keys.every(k => values[k] !== undefined)) {
+                    const record = Object.fromEntries(Object.entries(values).map(([k, vc]) => [k, vc.value]));
+                    emit(record);
+                }
+            });
+        });
+        return () => unsubFuncs.forEach(f => f());
+    });
+    return new EventEmitter(listen);
+}
+export function combineEmitters(emitters) {
+    if (Array.isArray(emitters))
+        return combineArray(emitters.map(toEventEmitter));
+    return combineRecord(Object.fromEntries(Object.entries(emitters).map(([k, e]) => [k, toEventEmitter(e)])));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtia/jel",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "repository": {
     "url": "https://github.com/tiadrop/jel-ts",
     "type": "github"