@manyducks.co/dolla 3.0.0 → 3.2.0

package/dist/core/context.d.ts

@@ -1,4 +1,5 @@
 import type { Store } from "../types.js";
+import { ViewNode } from "./markup/nodes/view.js";
 export type LifecycleListener = () => any;
 type ContextState = {
     isMounted: boolean;
@@ -13,6 +14,14 @@ export declare function unmountContext(context: Context): void;
 export declare function onMount(context: Context, fn: LifecycleListener): void;
 export declare function onCleanup(context: Context, fn: LifecycleListener): void;
 export declare function onEffect(context: Context, fn: () => void): void;
+/**
+ * Returns the parent element of the root we're mounted in.
+ */
+export declare function getRootElement(context: Context): Element;
+/**
+ * Returns the ViewNode of the nearest view up the context chain.
+ */
+export declare function getNearestViewNode<Props = unknown>(context: Context): ViewNode<Props> | undefined;
 export declare const STORE_ID: unique symbol;
 export declare function addStore<Props, Returns>(context: Context, store: Store<Props, Returns> & {
     [STORE_ID]?: symbol;

package/dist/core/index.d.ts

@@ -1,11 +1,11 @@
 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, getStore, onCleanup, onEffect, onMount } from "./context.js";
+export { addStore, getNearestViewNode, getRootElement, getStore, onCleanup, onEffect, onMount } from "./context.js";
 export type { Context } from "./context.js";
 export { createDebug, getDebug, setLogFilter, setLogLevel } from "./debug.js";
-export { forEach, showIf, hideIf, createPortal } from "./markup/helpers.js";
+export { createPortal, forEach, hideIf, showIf } from "./markup/helpers.js";
 export { html } from "./markup/html.js";
 export { ViewNode } from "./markup/nodes/view.js";
 export type { Markup, MarkupNode } from "./markup/types.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>];