@planet-matrix/mobius-model 0.1.4 → 0.3.0

package/dist/reactor/reactor-operators/filter.d.ts

@@ -0,0 +1,269 @@
+import type { Signal, SignalValueInitializer, ValueReactor } from "../reactor-core/index.ts";
+export interface CurrentOptions<V> {
+    target: ValueReactor<V>;
+}
+/**
+ * Returns a Signal that holds the current value of the target ValueReactor.
+ */
+export declare const current: <V>(options: CurrentOptions<V>) => Signal<V>;
+export interface NextOptions<V> {
+    target: ValueReactor<V>;
+    valueInitializer: SignalValueInitializer<V>;
+}
+/**
+ * Returns a Signal that holds the next value of the target ValueReactor
+ * after the initial value.
+ *
+ * The Signal will update its value only once, upon the next change of
+ * the target ValueReactor, and then it will not update anymore.
+ */
+export declare const next: <V>(options: NextOptions<V>) => Signal<V>;
+export interface FilterInitializingFalsyValueGetterContext<V> {
+    isInitializingRun: true;
+    targetValue: V;
+}
+export interface FilterUpdatingFalsyValueGetterContext<V> {
+    isInitializingRun: false;
+    targetValue: V;
+    previousValue: V;
+}
+export type FilterFalsyValueGetterContextOf<V> = FilterInitializingFalsyValueGetterContext<V> | FilterUpdatingFalsyValueGetterContext<V>;
+export interface FilterOptions<V> {
+    target: ValueReactor<V>;
+    truthyPredicate: (value: V) => boolean;
+    falsyValueGetter: (context: FilterFalsyValueGetterContextOf<V>) => V;
+}
+/**
+ * Returns a Signal that only updates its value from the target
+ * ValueReactor when the predicate function returns true.
+ */
+export declare const filter: <V>(options: FilterOptions<V>) => Signal<V>;
+export interface AuditByCountOptions<V> {
+    target: ValueReactor<V>;
+    count: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor after every specified count of emissions.
+ */
+export declare const auditByCount: <V>(options: AuditByCountOptions<V>) => Signal<V>;
+export interface AuditByTimeOptions<V> {
+    target: ValueReactor<V>;
+    time: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor at specified time intervals.
+ */
+export declare const auditByTime: <V>(options: AuditByTimeOptions<V>) => Signal<V>;
+export interface AuditByTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Returns a Signal that only updates its value when the trigger
+ * ValueReactor emits a value, using the latest value from the target
+ * ValueReactor.
+ */
+export declare const auditByTrigger: <VTarget, VTrigger>(options: AuditByTriggerOptions<VTarget, VTrigger>) => Signal<VTarget>;
+export interface AuditByToggleOptions<VTarget, VOpen, VClose> {
+    target: ValueReactor<VTarget>;
+    open: ValueReactor<VOpen>;
+    close: ValueReactor<VClose>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the close ValueReactor emits, but only
+ * if auditing was started by the open ValueReactor.
+ */
+export declare const auditByToggle: <VTarget, VOpen, VClose>(options: AuditByToggleOptions<VTarget, VOpen, VClose>) => Signal<VTarget>;
+export interface AuditByDynamicOptions<VTarget, VDynamic> {
+    target: ValueReactor<VTarget>;
+    dynamic: (value: VTarget) => ValueReactor<VDynamic>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the ValueReactor returned by the `dynamic`
+ * function emits. The `dynamic` function is called each time after emitting
+ * to get a new ValueReactor for the next audit period.
+ */
+export declare const auditByDynamic: <VTarget, VDynamic>(options: AuditByDynamicOptions<VTarget, VDynamic>) => Signal<VTarget>;
+export interface DebounceByCountOptions<V> {
+    target: ValueReactor<V>;
+    count: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor after the specified count of emissions
+ * without being updated.
+ */
+export declare const debounceByCount: <V>(options: DebounceByCountOptions<V>) => Signal<V>;
+export interface DebounceByTimeOptions<V> {
+    target: ValueReactor<V>;
+    time: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor after the specified time in milliseconds
+ * has passed since the last update.
+ */
+export declare const debounceByTime: <V>(options: DebounceByTimeOptions<V>) => Signal<V>;
+export interface DebounceByTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor whenever the trigger ValueReactor
+ * emits a value.
+ */
+export declare const debounceByTrigger: <VTarget, VTrigger>(options: DebounceByTriggerOptions<VTarget, VTrigger>) => Signal<VTarget>;
+export interface DebounceByToggleOptions<VTarget, VOpen, VClose> {
+    target: ValueReactor<VTarget>;
+    open: ValueReactor<VOpen>;
+    close: ValueReactor<VClose>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the close ValueReactor emits, but only
+ * if debouncing was started by the open ValueReactor.
+ */
+export declare const debounceByToggle: <VTarget, VOpen, VClose>(options: DebounceByToggleOptions<VTarget, VOpen, VClose>) => Signal<VTarget>;
+export interface DebounceByDynamicOptions<VTarget, VDynamic> {
+    target: ValueReactor<VTarget>;
+    dynamic: (value: VTarget) => ValueReactor<VDynamic>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the ValueReactor returned by the `dynamic`
+ * function emits. The `dynamic` function is called each time after emitting
+ * to get a new ValueReactor for the next debounce period.
+ */
+export declare const debounceByDynamic: <VTarget, VDynamic>(options: DebounceByDynamicOptions<VTarget, VDynamic>) => Signal<VTarget>;
+export interface ThrottleByCountOptions<V> {
+    target: ValueReactor<V>;
+    count: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor at most once every specified count of emissions.
+ */
+export declare const throttleByCount: <V>(options: ThrottleByCountOptions<V>) => Signal<V>;
+export interface ThrottleByTimeOptions<V> {
+    target: ValueReactor<V>;
+    time: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor at most once every specified time in milliseconds.
+ */
+export declare const throttleByTime: <V>(options: ThrottleByTimeOptions<V>) => Signal<V>;
+export interface ThrottleByTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor at most once whenever the trigger
+ * ValueReactor emits.
+ */
+export declare const throttleByTrigger: <VTarget, VTrigger>(options: ThrottleByTriggerOptions<VTarget, VTrigger>) => Signal<VTarget>;
+export interface ThrottleByToggleOptions<VTarget, VOpen, VClose> {
+    target: ValueReactor<VTarget>;
+    open: ValueReactor<VOpen>;
+    close: ValueReactor<VClose>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the close ValueReactor emits, but only
+ * if throttling was started by the open ValueReactor.
+ */
+export declare const throttleByToggle: <VTarget, VOpen, VClose>(options: ThrottleByToggleOptions<VTarget, VOpen, VClose>) => Signal<VTarget>;
+export interface ThrottleByDynamicOptions<VTarget, VDynamic> {
+    target: ValueReactor<VTarget>;
+    dynamic: (value: VTarget) => ValueReactor<VDynamic>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the ValueReactor returned by the `dynamic`
+ * function emits. The `dynamic` function is called each time after emitting
+ * to get a new ValueReactor for the next throttle period.
+ */
+export declare const throttleByDynamic: <VTarget, VDynamic>(options: ThrottleByDynamicOptions<VTarget, VDynamic>) => Signal<VTarget>;
+export interface DistinctOptions<V, K> {
+    target: ValueReactor<V>;
+    keyGetter?: (value: V) => K;
+}
+/**
+ * Returns a Signal that only updates its value with unique values
+ * from the target ValueReactor, determined by the key returned from
+ * the keyGetter function.
+ */
+export declare const distinct: <V, K>(options: DistinctOptions<V, K>) => Signal<V>;
+export interface DistinctUntilChangedOptions<V, K> {
+    target: ValueReactor<V>;
+    keyGetter?: (value: V) => K;
+}
+/**
+ * Returns a Signal that only updates its value when the key returned
+ * from the keyGetter function changes between emissions.
+ */
+export declare const distinctUntilChanged: <V, K>(options: DistinctUntilChangedOptions<V, K>) => Signal<V>;
+export interface TakeByPredicateOptions<V> {
+    target: ValueReactor<V>;
+    predicate: (value: V) => boolean;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor, but only while the predicate function
+ * returns true.
+ */
+export declare const takeByPredicate: <V>(options: TakeByPredicateOptions<V>) => Signal<V>;
+export interface TakeByCountOptions<V> {
+    target: ValueReactor<V>;
+    count: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor, but only for the first `count` emissions.
+ */
+export declare const takeByCount: <V>(options: TakeByCountOptions<V>) => Signal<V>;
+export interface TakeByTimeOptions<T> {
+    target: ValueReactor<T>;
+    time: number;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor, but only for the specified time in milliseconds.
+ */
+export declare const takeByTime: <T>(options: TakeByTimeOptions<T>) => Signal<T>;
+export interface TakeByTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor whenever the trigger ValueReactor emits a value.
+ */
+export declare const takeByTrigger: <VTarget, VTrigger>(options: TakeByTriggerOptions<VTarget, VTrigger>) => Signal<VTarget>;
+export interface TakeByToggleOptions<VTarget, VOpen, VClose> {
+    target: ValueReactor<VTarget>;
+    open: ValueReactor<VOpen>;
+    close: ValueReactor<VClose>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor when the close ValueReactor emits, but only
+ * if taking was started by the open ValueReactor.
+ */
+export declare const takeByToggle: <VTarget, VOpen, VClose>(options: TakeByToggleOptions<VTarget, VOpen, VClose>) => Signal<VTarget>;
+export interface TakeUntilTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Returns a Signal that updates its value with the latest value from
+ * the target ValueReactor until the trigger ValueReactor emits a value.
+ */
+export declare const takeUntilTrigger: <VTarget, VTrigger>(options: TakeUntilTriggerOptions<VTarget, VTrigger>) => Signal<VTarget>;
+//# sourceMappingURL=filter.d.ts.map

package/dist/reactor/reactor-operators/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/reactor/reactor-operators/filter.ts"],"names":[],"mappings":"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"}

package/dist/reactor/reactor-operators/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./utility.ts";
+export * from "./convert.ts";
+export * from "./create.ts";
+export * from "./join.ts";
+export * from "./branch.ts";
+export * from "./map.ts";
+export * from "./filter.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/reactor/reactor-operators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/reactor/reactor-operators/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/reactor/reactor-operators/join.d.ts

@@ -0,0 +1,48 @@
+import type { AnyValueReactorArray, AnyValueReactorObject, GetValuesInArray, GetValuesInObject } from "./utility.ts";
+import type { Signal, ValueReactor } from "../reactor-core/index.ts";
+export type CombineLatestArray<T extends AnyValueReactorArray> = Signal<GetValuesInArray<T>>;
+export interface CombineLatestArrayOptions<T extends AnyValueReactorArray> {
+    target: T;
+}
+/**
+ * Combines multiple ValueReactors into a Signal that emits the latest values
+ * from each ValueReactor whenever any of them updates.
+ */
+export declare const combineLatestArray: <T extends AnyValueReactorArray>(options: CombineLatestArrayOptions<T>) => CombineLatestArray<T>;
+export type CombineLatestObject<T extends AnyValueReactorObject> = Signal<GetValuesInObject<T>>;
+export interface CombineLatestObjectOptions<T extends AnyValueReactorObject> {
+    target: T;
+}
+/**
+ * Combines multiple ValueReactors in an object into a Signal that emits the latest values
+ * from each ValueReactor whenever any of them updates.
+ */
+export declare const combineLatestObject: <T extends AnyValueReactorObject>(options: CombineLatestObjectOptions<T>) => CombineLatestObject<T>;
+export type MergeArray<T extends AnyValueReactorArray> = Signal<GetValuesInArray<T>[number]>;
+export interface MergeArrayOptions<T extends AnyValueReactorArray> {
+    target: T;
+}
+/**
+ * Merges multiple ValueReactors into a Signal that emits values
+ * from any of the ValueReactors as they update.
+ */
+export declare const mergeArray: <T extends AnyValueReactorArray>(options: MergeArrayOptions<T>) => MergeArray<T>;
+export interface WithLatestFromOptions<T, U> {
+    target: ValueReactor<T>;
+    other: ValueReactor<U>;
+}
+/**
+ * Combines two ValueReactors into a Signal that emits the latest values
+ * from the source ValueReactor along with the latest value from the other ValueReactor.
+ */
+export declare const withLatestFrom: <T, U>(options: WithLatestFromOptions<T, U>) => Signal<[T, U]>;
+export interface ZipOptions<VA, VB> {
+    a: ValueReactor<VA>;
+    b: ValueReactor<VB>;
+}
+/**
+ * Zips two ValueReactors into a Signal that emits pairs of values.
+ * Each time both ValueReactors have new values, a new pair is emitted.
+ */
+export declare const zip: <VA, VB>(options: ZipOptions<VA, VB>) => Signal<[VA, VB]>;
+//# sourceMappingURL=join.d.ts.map

package/dist/reactor/reactor-operators/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../src/reactor/reactor-operators/join.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACpH,OAAO,KAAK,EAAU,MAAM,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAK5E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,oBAAoB,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7F,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,oBAAoB;IACvE,MAAM,EAAE,CAAC,CAAC;CACX;AACD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,8FAgBnC,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,qBAAqB,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAChG,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,qBAAqB;IACzE,MAAM,EAAE,CAAC,CAAC;CACX;AACD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,iGAgBpC,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,oBAAoB,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7F,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,oBAAoB;IAC/D,MAAM,EAAE,CAAC,CAAC;CACX;AACD;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,8EAwB3B,CAAA;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACxB;AACD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,yDAuBlC,CAAA;AAED,MAAM,WAAW,UAAU,CAAC,EAAE,EAAE,EAAE;IAChC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;CACrB;AACD;;;GAGG;AACH,eAAO,MAAM,GAAG,GAAI,EAAE,EAAE,EAAE,kDAwCzB,CAAA"}

package/dist/reactor/reactor-operators/map.d.ts

@@ -0,0 +1,165 @@
+import type { AnyValueReactor, Signal, ValueOfValueReactor, ValueReactor } from "../reactor-core/index.ts";
+export interface TapOptions<R extends AnyValueReactor> {
+    target: R;
+    tapper?: ((value: ValueOfValueReactor<R>) => void) | undefined;
+}
+/**
+ * Taps into the value changes of a ValueReactor without modifying its value.
+ */
+export declare const tap: <R extends AnyValueReactor>(options: TapOptions<R>) => R;
+export interface WithHistoryOptions<V> {
+    target: ValueReactor<V>;
+}
+/**
+ * Creates a signal that maintains a history of values from a ValueReactor.
+ * The history is stored in an array, with each new value appended to the end.
+ *
+ * Note: This implementation does not limit the size of the history array. Use
+ * with caution to avoid excessive memory usage.
+ */
+export declare const withHistory: <V>(options: WithHistoryOptions<V>) => Signal<V[]>;
+export interface BufferByCountOptions<V> {
+    target: ValueReactor<V>;
+    count: number;
+}
+/**
+ * Buffers values from a ValueReactor and emits them as an array
+ * when the number of buffered values reaches the specified count.
+ */
+export declare const bufferByCount: <V>(options: BufferByCountOptions<V>) => Signal<V[]>;
+export interface BufferByTimeOptions<V> {
+    target: ValueReactor<V>;
+    time: number;
+}
+/**
+ * Buffers values from a ValueReactor and emits them as an array
+ * at specified time intervals.
+ */
+export declare const bufferByTime: <V>(options: BufferByTimeOptions<V>) => Signal<V[]>;
+export interface BufferByTriggerOptions<VTarget, VTrigger> {
+    target: ValueReactor<VTarget>;
+    trigger: ValueReactor<VTrigger>;
+}
+/**
+ * Buffers values from a ValueReactor and emits them as an array when the trigger ValueReactor changes.
+ */
+export declare const bufferByTrigger: <VTarget, VTrigger>(options: BufferByTriggerOptions<VTarget, VTrigger>) => Signal<VTarget[]>;
+export interface BufferByToggleOptions<VTarget, VOpen, VClose> {
+    target: ValueReactor<VTarget>;
+    open: ValueReactor<VOpen>;
+    close: ValueReactor<VClose>;
+}
+/**
+ * Buffers values from a ValueReactor and emits them as an array
+ * when the open ValueReactor emits a value, and stops buffering
+ * when the close ValueReactor emits a value.
+ */
+export declare const bufferByToggle: <VTarget, VOpen, VClose>(options: BufferByToggleOptions<VTarget, VOpen, VClose>) => Signal<VTarget[]>;
+export interface BufferByDynamicOptions<VTarget, VDynamic> {
+    target: ValueReactor<VTarget>;
+    dynamic: (value: VTarget) => ValueReactor<VDynamic>;
+}
+/**
+ * Buffers values from a ValueReactor and emits them as an array
+ * when the ValueReactor returned by the `dynamic` function emits a value.
+ * The `dynamic` function is called each time the buffer is emitted
+ * to get a new ValueReactor for the next buffer.
+ */
+export declare const bufferByDynamic: <VTarget, VDynamic>(options: BufferByDynamicOptions<VTarget, VDynamic>) => Signal<VTarget[]>;
+export interface GroupToArrayByOptions<V, K> {
+    target: ValueReactor<V>;
+    keyGetter: (value: V) => K;
+}
+/**
+ * Groups values from a ValueReactor into an array of arrays based on a key
+ * extracted by the keyGetter function.
+ */
+export declare const groupToArrayBy: <V, K>(options: GroupToArrayByOptions<V, K>) => Signal<V[][]>;
+export interface GroupToObjectByOptions<V, K extends string | number | symbol> {
+    target: ValueReactor<V>;
+    keyGetter: (value: V) => K;
+}
+/**
+ * Groups values from a ValueReactor into an object where each key maps to an array
+ * of values corresponding to that key.
+ */
+export declare const groupToObjectBy: <V, K extends string | number | symbol>(options: GroupToObjectByOptions<V, K>) => Signal<Record<K, V[]>>;
+/**
+ * Groups values from a ValueReactor into an array of Signals based on a key
+ * extracted by the keyGetter function.
+ */
+export declare const groupToSignalArrayBy: <V, K>(target: ValueReactor<V>, keyGetter: (value: V) => K) => Signal<Signal<V[]>[]>;
+export interface GroupToSignalObjectByOptions<V, K extends string | number | symbol> {
+    target: ValueReactor<V>;
+    keyGetter: (value: V) => K;
+}
+/**
+ * Groups values from a ValueReactor into a Signal of an object where each key maps to a Signal
+ * of an array of values corresponding to that key.
+ */
+export declare const groupToSignalObjectBy: <V, K extends string | number | symbol>(options: GroupToSignalObjectByOptions<V, K>) => Signal<Record<K, Signal<V[]>>>;
+export interface MapOptions<VTarget, VMapped> {
+    target: ValueReactor<VTarget>;
+    mapper: (value: VTarget) => VMapped;
+}
+/**
+ * Maps values from a ValueReactor using the provided mapper function and
+ * emits the mapped values as a new Signal.
+ */
+export declare const map: <VTarget, VMapped>(options: MapOptions<VTarget, VMapped>) => Signal<VMapped>;
+export interface ContextualMapInitializingMapperContext<VTarget> {
+    isInitializingRun: true;
+    targetValue: VTarget;
+}
+export interface ContextualMapUpdatingMapperContext<VTarget, VMapped> {
+    isInitializingRun: false;
+    targetValue: VTarget;
+    previousMappedValue: VMapped;
+}
+export type ContextualMapMapperContextOf<VTarget, VMapped> = ContextualMapInitializingMapperContext<VTarget> | ContextualMapUpdatingMapperContext<VTarget, VMapped>;
+export interface ContextualMapOptions<VTarget, VMapped> {
+    target: ValueReactor<VTarget>;
+    mapper: (context: ContextualMapMapperContextOf<VTarget, VMapped>) => VMapped;
+}
+/**
+ * Maps values from a ValueReactor using the provided contextual mapper function and
+ * emits the mapped values as a new Signal.
+ */
+export declare const contextualMap: <VTarget, VMapped>(options: ContextualMapOptions<VTarget, VMapped>) => Signal<VMapped>;
+export interface MergeMapOptions<VTarget, VMapped> {
+    target: ValueReactor<VTarget>;
+    mapper: (value: VTarget) => ValueReactor<VMapped>;
+}
+/**
+ * Maps each value from a ValueReactor<T> to a ValueReactor<R> using the provided `mapper`,
+ * subscribes to every mapped reactor, and merges their emitted values into a single `Signal<R>`.
+ */
+export declare const mergeMap: <VTarget, VMapped>(options: MergeMapOptions<VTarget, VMapped>) => Signal<VMapped>;
+export interface SwitchMapOptions<VTarget, VMapped> {
+    target: ValueReactor<VTarget>;
+    mapper: (value: VTarget) => ValueReactor<VMapped>;
+}
+/**
+ * Maps each value from a ValueReactor<T> to a ValueReactor<R> using the provided `mapper`,
+ * subscribes only to the latest mapped reactor, and emits its values as a `Signal<R>`.
+ */
+export declare const switchMap: <VTarget, VMapped>(options: SwitchMapOptions<VTarget, VMapped>) => Signal<VMapped>;
+export interface ScanOptions<VTarget, VAccumulated> {
+    target: ValueReactor<VTarget>;
+    accumulator: (acc: VAccumulated, value: VTarget) => VAccumulated;
+    seed: VAccumulated;
+}
+/**
+ * Accumulates values from a ValueReactor using the provided accumulator function
+ * and emits the accumulated value as a Signal.
+ */
+export declare const scan: <VTarget, VAccumulated>(options: ScanOptions<VTarget, VAccumulated>) => Signal<VAccumulated>;
+export interface PairwiseOptions<V> {
+    target: ValueReactor<V>;
+}
+/**
+ * Emits the previous and current values from a ValueReactor as a tuple.
+ * The first emitted tuple will have `undefined` as the previous value.
+ */
+export declare const pairwise: <V>(options: PairwiseOptions<V>) => Signal<[V | undefined, V]>;
+//# sourceMappingURL=map.d.ts.map

package/dist/reactor/reactor-operators/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/reactor/reactor-operators/map.ts"],"names":[],"mappings":"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"}

package/dist/reactor/reactor-operators/utility.d.ts

@@ -0,0 +1,48 @@
+import type { ValueReactor } from "../reactor-core/index.ts";
+export type ValueInitializer<V> = () => V;
+/**
+ * This initializer can be used to create a Signal with an undefined initial value which
+ * is casted to the desired type T. So the real value getter function will not be called
+ * until the Signal is actually used.
+ *
+ * Every signal should always have a valid value (or value getter which returns a valid value).
+ * When using the castValueInitializer, the real value should be set as soon as possible.
+ */
+export declare const castValueInitializer: <V>() => ValueInitializer<V>;
+export type Unsubscribe = () => void;
+export interface SubscribeOptions<V> {
+    target: ValueReactor<V>;
+    subscriber: (value: V) => void;
+}
+/**
+ * Subscribes to a ValueReactor and invokes the subscriber when the reactor's value
+ * changes.
+ *
+ * The initial value is skipped; the subscriber is called only on subsequent updates.
+ */
+export declare const subscribe: <V>(options: SubscribeOptions<V>) => Unsubscribe;
+export type AnyValueReactorArray = Array<ValueReactor<any>>;
+export type GetValuesInArray<T extends AnyValueReactorArray> = {
+    [K in keyof T]: T[K] extends ValueReactor<infer U> ? U : never;
+};
+export interface GetValuesInArrayOptions<T extends AnyValueReactorArray> {
+    target: T;
+    withoutTrack?: boolean;
+}
+/**
+ * Gets the current values from an array of ValueReactors.
+ */
+export declare const getValuesInArray: <T extends AnyValueReactorArray>(options: GetValuesInArrayOptions<T>) => GetValuesInArray<T>;
+export type AnyValueReactorObject = Record<string, ValueReactor<any>>;
+export type GetValuesInObject<T extends AnyValueReactorObject> = {
+    [K in keyof T]: T[K] extends ValueReactor<infer U> ? U : never;
+};
+export interface GetValueInObjectOptions<T extends AnyValueReactorObject> {
+    target: T;
+    withoutTrack?: boolean;
+}
+/**
+ * Gets the current values from an object of ValueReactors.
+ */
+export declare const getValuesInObject: <T extends AnyValueReactorObject>(options: GetValueInObjectOptions<T>) => GetValuesInObject<T>;
+//# sourceMappingURL=utility.d.ts.map

package/dist/reactor/reactor-operators/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../src/reactor/reactor-operators/utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAC1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,0BAKrC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AACpC,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAChC;AACD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,8CAgB1B,CAAA;AAGD,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,oBAAoB,IAAI;KAC5D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAC/D,CAAA;AACD,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,oBAAoB;IACrE,MAAM,EAAE,CAAC,CAAC;IACV,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AACD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,0FAWjC,CAAA;AAGD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAC/D,CAAA;AACD,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,qBAAqB;IACtE,MAAM,EAAE,CAAC,CAAC;IACV,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AACD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,4FAelC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planet-matrix/mobius-model",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "Mobius model.",
   "keywords": [
     "mobius",
@@ -60,14 +60,14 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@planet-matrix/mobius-mono": "0.5.0",
-    "@types/bun": "^1.3.5",
-    "oxlint": "^1.37.0",
-    "oxlint-tsgolint": "^0.10.1",
-    "typescript": "^5.9.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260101.1",
-    "vite": "^7.2.6",
-    "vitest": "^4.0.15"
+    "@planet-matrix/mobius-mono": "0.6.0",
+    "@types/bun": "^1.3.8",
+    "oxlint": "^1.42.0",
+    "oxlint-tsgolint": "^0.11.4",
+    "typescript": "^5.9.3",
+    "@typescript/native-preview": "^7.0.0-dev.20260130.1",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {},
   "peerDependenciesMeta": {},

package/src/index.ts

@@ -1 +1 @@
-export * from "./signal/index.ts"
+export * as Reactor from "./reactor/index.ts"

package/src/reactor/README.md

@@ -0,0 +1,18 @@
+# Reactor
+
+Reactor 的实现与以下项目有关：
+
+- [alien-signals](https://github.com/stackblitz/alien-signals): Reactor 源于该项目，是在对该项目进行重构的基础上添加了其它个性化实现得到的，两者核心区别包括：1、alien-signals 的 API 更加“函数式”，而 Reactor 的 API 更加“对象式”；2、alien-signals 的源码更注重性能，因而比较晦涩，而 Reactor 的实现更注重可维护性与可扩展性因而比较易懂；3、alien-signals 的功能更单一更克制，几乎只提供了核心的响应式算法，而 Reactor 则提供了更多的相关功能与工具函数。
+- [Preact signals](https://github.com/preactjs/signals)：受该项目启发，Reactor 补充了一些额外能力，包括但不限于 `options parameter`、`signal.getWithoutTrack()`（同 `signal.peek()`）、`batch()`、`withoutTracking()`（同 `untracked()`）。
+- [Angular signals](https://angular.dev/guide/signals): 受该项目启发，Reactor 补充了一些额外能力，包括但不限于 `assertWithoutTracking()`（同 `assertNotInReactiveContext()`）、`options.isEqual()`（同 `options.equal()`）、`signal.setWithoutCalculate()`（同 `signal.update()`）、`derived()`（原语层面的 `linkedSignal()`）。
+- [RxJS](https://github.com/ReactiveX/rxjs)：Reactor 的 operators 参考了 RxJS 的 operators 列表与功能，但两者有着本质的区别，RxJS 的 operators 负责管理值的流动与转换，而 Reactor 的 operators 只是围绕 Reactor 原语提供的一些便捷工具函数，Reactor 的核心价值在于其响应式原语，而非 operators，operators 对于 RxJS 来说不可或缺，但 operators 对于 Reactor 来说并非必需。
+
+Reactor operators 分为以下几类：
+
+1. utility：实用工具函数。
+2. convert：类型转换相关。
+3. create：创建相关。
+4. join：合并相关（多个 Reactor 组合为一个 Reactor）。
+5. branch：分支相关（一个 Reactor 变为多个 Reactor）。
+6. map：映射相关（一个 Reactor 变换为另一个 Reactor）。
+7. filter：过滤相关（一个 Reactor 变换为另一个 Reactor，本质是特殊的 map）。

package/src/reactor/index.ts

@@ -0,0 +1,2 @@
+export * from "./reactor-core/index.ts"
+export * from "./reactor-operators/index.ts"