@manyducks.co/dolla 3.1.0 → 3.2.0

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
 export { createRoot } from "./root.js";
 export type { DollaPlugin } from "./root.js";
-export { batch, compose, createAtom, createEffect, peek, subscribe, unwrap } from "./signals.js";
+export { batch, compose, createAtom, createEffect, createStream, peek, subscribe, unwrap } from "./signals.js";
 export type { Getter, Setter } from "./signals.js";
 export { addStore, getNearestViewNode, getRootElement, getStore, onCleanup, onEffect, onMount } from "./context.js";
 export type { Context } from "./context.js";

package/dist/core/signals.d.ts

@@ -1,3 +1,4 @@
+import { Context } from "./index.js";
 /**
  * Returns the currently held value. Registers the state as a dependency when called within a tracking context.
  */
@@ -50,7 +51,7 @@ export declare function createAtom<T>(compute: Getter<T>): AtomAccessors<T>;
  * const [getCount, setCount] = createAtom(5);
  */
 export declare function createAtom<T>(initialValue: T): AtomAccessors<T>;
-export declare function compose<T>(getter: (previousValue?: T) => Getter<T> | T): Getter<T>;
+export declare function compose<T>(getter: T | ((previousValue?: T) => Getter<T> | T)): Getter<T>;
 export declare function createEffect(fn: () => void): () => void;
 /**
  * Unwraps a `MaybeGetter<T>` into a plain `T`.
@@ -68,3 +69,34 @@ export declare function peek<T>(value: T | Getter<T>): T;
  */
 export declare function batch(callback: () => void): void;
 export declare function subscribe<T>(target: Getter<T>, fn: (value: T) => any): () => void;
+export interface StreamOptions<T> {
+    /**
+     * An initial value for non-nullable streams.
+     */
+    initialValue?: T;
+    /**
+     * Cancel pending `next` listeners when this context is unmounted.
+     */
+    context?: Context;
+    /**
+     * Number of emitted values to keep. Defaults to 0 (latest value only).
+     */
+    history?: number;
+}
+export interface StreamOptionsWithValue<T> extends StreamOptions<T> {
+    initialValue: T;
+}
+export interface Stream<T> {
+    readonly latest: T;
+    current: Getter<T>;
+    next(): Promise<T>;
+    map<O>(callback: (value: T, previous?: O) => O): Stream<O>;
+    reduce<O>(callback: (reduced: O, value: T) => O, initialValue: O): Stream<O>;
+    filter(callback: (value: T, previous?: T) => boolean, defaultValue: T): Stream<T>;
+    filter(callback: (value: T, previous?: T) => boolean, defaultValue?: T): Stream<T | undefined>;
+    throttle(milliseconds: number): Stream<T>;
+    debounce(milliseconds: number): Stream<T>;
+    delay(milliseconds: number, initialValue?: T): Stream<T>;
+}
+export declare function createStream<T>(options: StreamOptionsWithValue<T>): [Stream<T>, Setter<T>];
+export declare function createStream<T>(options: StreamOptions<T>): [Stream<T | undefined>, Setter<T | undefined>];