synstate 0.1.0 → 0.1.2

package/dist/core/combine/combine.d.mts

@@ -9,26 +9,56 @@ import { type CombineObservableRefined, type Observable } from '../types/index.m
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  name$     "Alice"                 "Bob"
+ * //  age$                25                        30
+ * //  user$               ["Alice",25]  ["Bob",25]  ["Bob",30]
+ * //
+ * //  Explanation:
+ * //  - combine waits for all sources to emit at least once
+ * //  - Then emits the latest value from all sources whenever any source emits
+ * //  - Always emits an array with the latest values from each source
+ *
  * const name$ = source<string>();
  *
  * const age$ = source<number>();
  *
  * const user$ = combine([name$, age$]);
  *
+ * const mut_history: (readonly [string, number])[] = [];
+ *
  * user$.subscribe(([name_, age]) => {
- *   console.log({ name: name_, age });
+ *   mut_history.push([name_, age]);
  * });
  *
- * name$.next('Alice');
+ * name$.next('Alice'); // nothing logged (age$ hasn't emitted yet)
+ *
+ * assert.deepStrictEqual(mut_history, []);
  *
  * age$.next(25); // logs: { name: 'Alice', age: 25 }
  *
+ * assert.deepStrictEqual(mut_history, [['Alice', 25]]);
+ *
  * name$.next('Bob'); // logs: { name: 'Bob', age: 25 }
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['Alice', 25],
+ *   ['Bob', 25],
+ * ]);
+ *
+ * age$.next(30); // logs: { name: 'Bob', age: 30 }
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['Alice', 25],
+ *   ['Bob', 25],
+ *   ['Bob', 30],
+ * ]);
  * ```
  */
 export declare const combine: <const OS extends NonEmptyArray<Observable<unknown>>>(parents: OS) => CombineObservableRefined<OS>;
 /**
- * Alias for `combine()`.
+ * Alias for `combine`.
  * @see combine
  */
 export declare const combineLatest: <const OS extends NonEmptyArray<Observable<unknown>>>(parents: OS) => CombineObservableRefined<OS>;

package/dist/core/combine/combine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"combine.d.mts","sourceRoot":"","sources":["../../../src/core/combine/combine.mts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,wBAAwB,EAI7B,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACzE,SAAS,EAAE,KACV,wBAAwB,CAAC,EAAE,CAIgB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,aAAa,SAZI,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAChE,EAAE,KACV,wBAAwB,CAAC,EAAE,CAUM,CAAC"}
+{"version":3,"file":"combine.d.mts","sourceRoot":"","sources":["../../../src/core/combine/combine.mts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,wBAAwB,EAI7B,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACzE,SAAS,EAAE,KACV,wBAAwB,CAAC,EAAE,CAIgB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,aAAa,SAZI,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,WAChE,EAAE,KACV,wBAAwB,CAAC,EAAE,CAUM,CAAC"}

package/dist/core/combine/combine.mjs

@@ -15,31 +15,61 @@ import { withInitialValue } from '../operators/with-initial-value.mjs';
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  name$     "Alice"                 "Bob"
+ * //  age$                25                        30
+ * //  user$               ["Alice",25]  ["Bob",25]  ["Bob",30]
+ * //
+ * //  Explanation:
+ * //  - combine waits for all sources to emit at least once
+ * //  - Then emits the latest value from all sources whenever any source emits
+ * //  - Always emits an array with the latest values from each source
+ *
  * const name$ = source<string>();
  *
  * const age$ = source<number>();
  *
  * const user$ = combine([name$, age$]);
  *
+ * const mut_history: (readonly [string, number])[] = [];
+ *
  * user$.subscribe(([name_, age]) => {
- *   console.log({ name: name_, age });
+ *   mut_history.push([name_, age]);
  * });
  *
- * name$.next('Alice');
+ * name$.next('Alice'); // nothing logged (age$ hasn't emitted yet)
+ *
+ * assert.deepStrictEqual(mut_history, []);
  *
  * age$.next(25); // logs: { name: 'Alice', age: 25 }
  *
+ * assert.deepStrictEqual(mut_history, [['Alice', 25]]);
+ *
  * name$.next('Bob'); // logs: { name: 'Bob', age: 25 }
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['Alice', 25],
+ *   ['Bob', 25],
+ * ]);
+ *
+ * age$.next(30); // logs: { name: 'Bob', age: 30 }
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['Alice', 25],
+ *   ['Bob', 25],
+ *   ['Bob', 30],
+ * ]);
  * ```
  */
 const combine = (parents) => 
 // eslint-disable-next-line total-functions/no-unsafe-type-assertion
 new CombineObservableClass(parents);
 /**
- * Alias for `combine()`.
+ * Alias for `combine`.
  * @see combine
  */
-const combineLatest = combine; // alias
+const combineLatest = combine;
 class CombineObservableClass extends SyncChildObservableClass {
     constructor(parents) {
         const parentsValues = parents.map((p) => p.getSnapshot());

package/dist/core/combine/combine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"combine.mjs","sources":["../../../src/core/combine/combine.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;AACI,MAAM,OAAO,GAAG,CACrB,OAAW;AAEX;AACA,IAAI,sBAAsB,CACxB,OAAO;AAGX;;;AAGG;AACI,MAAM,aAAa,GAAG,QAAQ;AAErC,MAAM,sBACJ,SAAQ,wBAA8B,CAAA;AAGtC,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEzD,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM;kBAC7C,QAAQ,CAAC,IAAI;;AAEX,gBAAA,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;kBAE7C,QAAQ,CAAC,IAAI;AAClB,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC;AAAE,YAAA,OAAO;AAEzE,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAE7D,IAAI,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AACvC,YAAA,MAAM,SAAS;;AAEb,YAAA,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;AAE5C,YAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;;AAG3C;AAED;IACE;AACE,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;AAErC,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;QAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;IAO7B;AACE,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1E,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;QAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;IAO7B;AACE,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1E,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAE/D,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;;AAM7B,IAAA,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/B,IAAA,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IAEf,OAAO,CAAC;AAClB,QAAA,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC5B,QAAA,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC7B,KAAA;AAQH;;;;"}
+{"version":3,"file":"combine.mjs","sources":["../../../src/core/combine/combine.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDG;AACI,MAAM,OAAO,GAAG,CACrB,OAAW;AAEX;AACA,IAAI,sBAAsB,CACxB,OAAO;AAGX;;;AAGG;AACI,MAAM,aAAa,GAAG;AAE7B,MAAM,sBACJ,SAAQ,wBAA8B,CAAA;AAGtC,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEzD,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM;kBAC7C,QAAQ,CAAC,IAAI;;AAEX,gBAAA,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;kBAE7C,QAAQ,CAAC,IAAI;AAClB,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,KAAK,aAAa,CAAC;AAAE,YAAA,OAAO;AAEzE,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAE7D,IAAI,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AACvC,YAAA,MAAM,SAAS;;AAEb,YAAA,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;AAE5C,YAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;;AAG3C;AAED;IACE;AACE,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;AAErC,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;QAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;IAO7B;AACE,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1E,QAAA,MAAM,EAAE,GAAkB,MAAM,EAAK;QAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;IAO7B;AACE,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1E,QAAA,MAAM,EAAE,GAA6B,MAAM,EAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAE/D,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;;;AAM7B,IAAA,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/B,IAAA,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IAEf,OAAO,CAAC;AAClB,QAAA,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC5B,QAAA,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAC7B,KAAA;AAQH;;;;"}

package/dist/core/combine/merge.d.mts

@@ -9,16 +9,42 @@ import { type MergeObservableRefined, type Observable } from '../types/index.mjs
  *
  * @example
  * ```ts
- * const clicks$ = source<MouseEvent>();
+ * //  Timeline:
+ * //
+ * //  clicks$   c1          c2                    c3
+ * //  keys$               k1          k2                    k3
+ * //  events$   c1        k1    c2    k2          c3        k3
+ * //
+ * //  Explanation:
+ * //  - merge combines multiple observables into one
+ * //  - Emits values from any source as they arrive
+ * //  - Order is preserved based on emission time
  *
- * const keys$ = source<KeyboardEvent>();
+ * const clicks$ = source<string>();
+ *
+ * const keys$ = source<string>();
  *
  * const events$ = merge([clicks$, keys$]);
  *
+ * const mut_history: string[] = [];
+ *
  * events$.subscribe((event_) => {
- *   console.log(event_);
+ *   mut_history.push(event_);
  * });
- * // Logs any mouse click or keyboard event
+ *
+ * clicks$.next('c1');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1']);
+ *
+ * keys$.next('k1');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1', 'k1']);
+ *
+ * clicks$.next('c2');
+ *
+ * keys$.next('k2');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1', 'k1', 'c2', 'k2']);
  * ```
  *
  * @note To improve code readability, consider using `createState` instead of `merge`,

package/dist/core/combine/merge.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.mts","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACvE,SAAS,EAAE,KACV,sBAAsB,CAAC,EAAE,CAEqC,CAAC"}
+{"version":3,"file":"merge.d.mts","sourceRoot":"","sources":["../../../src/core/combine/merge.mts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACvE,SAAS,EAAE,KACV,sBAAsB,CAAC,EAAE,CAEqC,CAAC"}

package/dist/core/combine/merge.mjs

@@ -12,16 +12,42 @@ import '../utils/id-maker.mjs';
  *
  * @example
  * ```ts
- * const clicks$ = source<MouseEvent>();
+ * //  Timeline:
+ * //
+ * //  clicks$   c1          c2                    c3
+ * //  keys$               k1          k2                    k3
+ * //  events$   c1        k1    c2    k2          c3        k3
+ * //
+ * //  Explanation:
+ * //  - merge combines multiple observables into one
+ * //  - Emits values from any source as they arrive
+ * //  - Order is preserved based on emission time
  *
- * const keys$ = source<KeyboardEvent>();
+ * const clicks$ = source<string>();
+ *
+ * const keys$ = source<string>();
  *
  * const events$ = merge([clicks$, keys$]);
  *
+ * const mut_history: string[] = [];
+ *
  * events$.subscribe((event_) => {
- *   console.log(event_);
+ *   mut_history.push(event_);
  * });
- * // Logs any mouse click or keyboard event
+ *
+ * clicks$.next('c1');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1']);
+ *
+ * keys$.next('k1');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1', 'k1']);
+ *
+ * clicks$.next('c2');
+ *
+ * keys$.next('k2');
+ *
+ * assert.deepStrictEqual(mut_history, ['c1', 'k1', 'c2', 'k2']);
  * ```
  *
  * @note To improve code readability, consider using `createState` instead of `merge`,

package/dist/core/combine/merge.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"merge.mjs","sources":["../../../src/core/combine/merge.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAaA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACI,MAAM,KAAK,GAAG,CACnB,OAAW;AAEX;AACA,IAAI,oBAAoB,CAAC,OAAO;AAElC,MAAM,oBACJ,SAAQ,wBAA4C,CAAA;AAGpD,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,QAAQ,CAAC,IAAI;AAC5B,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CACnC,CAAC,CAAC,KACA,CAAC,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACxE;QAED,IAAI,WAAW,KAAK,SAAS;YAAE;AAE/B,QAAA,MAAM,SAAS;;QAEb,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAoB;AAE/D,QAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;AAEzC;;;;"}
+{"version":3,"file":"merge.mjs","sources":["../../../src/core/combine/merge.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDG;AACI,MAAM,KAAK,GAAG,CACnB,OAAW;AAEX;AACA,IAAI,oBAAoB,CAAC,OAAO;AAElC,MAAM,oBACJ,SAAQ,wBAA4C,CAAA;AAGpD,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,QAAQ,CAAC,IAAI;AAC5B,SAAA,CAAC;;AAGK,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CACnC,CAAC,CAAC,KACA,CAAC,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACxE;QAED,IAAI,WAAW,KAAK,SAAS;YAAE;AAE/B,QAAA,MAAM,SAAS;;QAEb,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAoB;AAE/D,QAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;AAEzC;;;;"}

package/dist/core/combine/zip.d.mts

@@ -10,16 +10,41 @@ import { type Observable, type ZipObservableRefined } from '../types/index.mjs';
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  letters$  'a'       'b'       'c'
+ * //  numbers$  1         2         3
+ * //  zipped$   ['a',1]   ['b',2]   ['c',3]
+ * //
+ * //  Explanation:
+ * //  - zip pairs values by their index from multiple sources
+ * //  - Waits for all sources to emit at the same index
+ * //  - Completes when any source completes
+ *
  * const letters$ = fromArray(['a', 'b', 'c']);
  *
  * const numbers$ = fromArray([1, 2, 3]);
  *
  * const zipped$ = zip([letters$, numbers$]);
  *
- * zipped$.subscribe(([letter, num]) => {
- *   console.log(letter, num);
+ * const mut_history: (readonly [string, number])[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   zipped$.subscribe(
+ *     ([letter, num]) => {
+ *       mut_history.push([letter, num]);
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
- * // logs: a 1, b 2, c 3
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 3],
+ * ]);
  * ```
  */
 export declare const zip: <const OS extends NonEmptyArray<Observable<unknown>>>(parents: OS) => ZipObservableRefined<OS>;

package/dist/core/combine/zip.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"zip.d.mts","sourceRoot":"","sources":["../../../src/core/combine/zip.mts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,UAAU,EAMf,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,GAAG,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACrE,SAAS,EAAE,KACV,oBAAoB,CAAC,EAAE,CAE8C,CAAC"}
+{"version":3,"file":"zip.d.mts","sourceRoot":"","sources":["../../../src/core/combine/zip.mts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,UAAU,EAMf,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,GAAG,GAAI,KAAK,CAAC,EAAE,SAAS,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EACrE,SAAS,EAAE,KACV,oBAAoB,CAAC,EAAE,CAE8C,CAAC"}

package/dist/core/combine/zip.mjs

@@ -13,16 +13,41 @@ import '../utils/id-maker.mjs';
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  letters$  'a'       'b'       'c'
+ * //  numbers$  1         2         3
+ * //  zipped$   ['a',1]   ['b',2]   ['c',3]
+ * //
+ * //  Explanation:
+ * //  - zip pairs values by their index from multiple sources
+ * //  - Waits for all sources to emit at the same index
+ * //  - Completes when any source completes
+ *
  * const letters$ = fromArray(['a', 'b', 'c']);
  *
  * const numbers$ = fromArray([1, 2, 3]);
  *
  * const zipped$ = zip([letters$, numbers$]);
  *
- * zipped$.subscribe(([letter, num]) => {
- *   console.log(letter, num);
+ * const mut_history: (readonly [string, number])[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   zipped$.subscribe(
+ *     ([letter, num]) => {
+ *       mut_history.push([letter, num]);
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
- * // logs: a 1, b 2, c 3
+ *
+ * assert.deepStrictEqual(mut_history, [
+ *   ['a', 1],
+ *   ['b', 2],
+ *   ['c', 3],
+ * ]);
  * ```
  */
 const zip = (parents) => 

package/dist/core/combine/zip.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"zip.mjs","sources":["../../../src/core/combine/zip.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACI,MAAM,GAAG,GAAG,CACjB,OAAW;AAEX;AACA,IAAI,kBAAkB,CAAC,OAAO;AAEhC,MAAM,kBACJ,SAAQ,wBAA8B,CAAA;AAG7B,IAAA,OAAO;AAEhB,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEzD,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM;kBAC7C,QAAQ,CAAC,IAAI;;AAEX,gBAAA,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;kBAE7C,QAAQ,CAAC,IAAI;AAClB,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,MAC9B,WAAW,EAAE,CACiB;;AAGzB,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO;AAE3B,QAAA,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE;AACjD,YAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,YAAA,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBAC9D,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC;;;AAIpC,QAAA,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;AACzC,YAAA,MAAM,SAAS;;YAEb,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAM;AAE3D,YAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;;AAG3C;;;;"}
+{"version":3,"file":"zip.mjs","sources":["../../../src/core/combine/zip.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CG;AACI,MAAM,GAAG,GAAG,CACjB,OAAW;AAEX;AACA,IAAI,kBAAkB,CAAC,OAAO;AAEhC,MAAM,kBACJ,SAAQ,wBAA8B,CAAA;AAG7B,IAAA,OAAO;AAEhB,IAAA,WAAA,CAAY,OAAgB,EAAA;AAC1B,QAAA,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEzD,QAAA,KAAK,CAAC;YACJ,OAAO;YACP,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM;kBAC7C,QAAQ,CAAC,IAAI;;AAEX,gBAAA,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAM;kBAE7C,QAAQ,CAAC,IAAI;AAClB,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,MAC9B,WAAW,EAAE,CACiB;;AAGzB,IAAA,SAAS,CAAC,aAA4B,EAAA;AAC7C,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO;AAE3B,QAAA,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE;AACjD,YAAA,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE;AAE5B,YAAA,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBAC9D,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC;;;AAIpC,QAAA,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;AACzC,YAAA,MAAM,SAAS;;YAEb,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAM;AAE3D,YAAA,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC;;;AAG3C;;;;"}

package/dist/core/create/from-array.d.mts

@@ -9,12 +9,30 @@ import { type FromArrayObservable } from '../types/index.mjs';
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  nums$     1     2     3     | (completes)
+ * //
+ * //  Explanation:
+ * //  - fromArray creates an observable from an array
+ * //  - Emits all values synchronously, then completes
+ *
  * const nums$ = fromArray([1, 2, 3]);
  *
- * nums$.subscribe((x) => {
- *   console.log(x);
+ * const mut_history: number[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   nums$.subscribe(
+ *     (x) => {
+ *       mut_history.push(x);
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
- * // logs: 1, 2, 3
+ *
+ * assert.deepStrictEqual(mut_history, [1, 2, 3]);
  * ```
  */
 export declare const fromArray: <A>(values: readonly A[], startManually?: boolean) => FromArrayObservable<A>;

package/dist/core/create/from-array.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"from-array.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-array.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,QAAQ,SAAS,CAAC,EAAE,EACpB,gBAAe,OAAe,KAC7B,mBAAmB,CAAC,CAAC,CACgC,CAAC"}
+{"version":3,"file":"from-array.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-array.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,QAAQ,SAAS,CAAC,EAAE,EACpB,gBAAe,OAAe,KAC7B,mBAAmB,CAAC,CAAC,CACgC,CAAC"}

package/dist/core/create/from-array.mjs

@@ -12,12 +12,30 @@ import { RootObservableClass } from '../class/root-observable-class.mjs';
  *
  * @example
  * ```ts
+ * //  Timeline:
+ * //
+ * //  nums$     1     2     3     | (completes)
+ * //
+ * //  Explanation:
+ * //  - fromArray creates an observable from an array
+ * //  - Emits all values synchronously, then completes
+ *
  * const nums$ = fromArray([1, 2, 3]);
  *
- * nums$.subscribe((x) => {
- *   console.log(x);
+ * const mut_history: number[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   nums$.subscribe(
+ *     (x) => {
+ *       mut_history.push(x);
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
- * // logs: 1, 2, 3
+ *
+ * assert.deepStrictEqual(mut_history, [1, 2, 3]);
  * ```
  */
 const fromArray = (values, startManually = false) => new FromArrayObservableClass(values, startManually);

package/dist/core/create/from-array.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"from-array.mjs","sources":["../../../src/core/create/from-array.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;;AAiBG;AACI,MAAM,SAAS,GAAG,CACvB,MAAoB,EACpB,aAAA,GAAyB,KAAK,KAE9B,IAAI,wBAAwB,CAAI,MAAM,EAAE,aAAa;AAEvD,MAAM,wBACJ,SAAQ,mBAAsB,CAAA;AAGrB,IAAA,OAAO;IAEhB,WAAA,CAAY,MAAoB,EAAE,aAAA,GAAyB,KAAK,EAAA;QAC9D,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAEtC,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM;QAErB,IAAI,CAAC,aAAa,EAAE;YAClB,UAAU,CAAC,MAAK;gBACd,IAAI,CAAC,IAAI,EAAE;YACb,CAAC,EAAE,CAAC,CAAC;QACP;IACF;IAEA,IAAI,GAAA;QACF,IAAI,IAAI,CAAC,WAAW;AAAE,YAAA,OAAO,IAAI;AAEjC,QAAA,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE;AAC5B,YAAA,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACrB;QAEA,IAAI,CAAC,QAAQ,EAAE;AAEf,QAAA,OAAO,IAAI;IACb;AACD;;;;"}
+{"version":3,"file":"from-array.mjs","sources":["../../../src/core/create/from-array.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCG;AACI,MAAM,SAAS,GAAG,CACvB,MAAoB,EACpB,aAAA,GAAyB,KAAK,KAE9B,IAAI,wBAAwB,CAAI,MAAM,EAAE,aAAa;AAEvD,MAAM,wBACJ,SAAQ,mBAAsB,CAAA;AAGrB,IAAA,OAAO;IAEhB,WAAA,CAAY,MAAoB,EAAE,aAAA,GAAyB,KAAK,EAAA;QAC9D,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAEtC,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM;QAErB,IAAI,CAAC,aAAa,EAAE;YAClB,UAAU,CAAC,MAAK;gBACd,IAAI,CAAC,IAAI,EAAE;YACb,CAAC,EAAE,CAAC,CAAC;QACP;IACF;IAEA,IAAI,GAAA;QACF,IAAI,IAAI,CAAC,WAAW;AAAE,YAAA,OAAO,IAAI;AAEjC,QAAA,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE;AAC5B,YAAA,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACrB;QAEA,IAAI,CAAC,QAAQ,EAAE;AAEf,QAAA,OAAO,IAAI;IACb;AACD;;;;"}

package/dist/core/create/from-promise.d.mts

@@ -10,15 +10,37 @@ import { type FromPromiseObservable } from '../types/index.mjs';
  *
  * @example
  * ```ts
- * const data$ = fromPromise(fetch('/api/data').then((r) => r.json()));
+ * //  Timeline:
+ * //
+ * //  promise     [pending...]  -> resolved/rejected
+ * //  data$                     Ok(value) or Err(error)
+ * //
+ * //  Explanation:
+ * //  - fromPromise converts a Promise into an observable
+ * //  - Emits a Result type: Ok(value) on success, Err(error) on failure
+ * //  - Completes after emitting the result
+ * //  - Useful for integrating async operations into reactive flows
  *
- * data$.subscribe((result) => {
- *   if (Result.isOk(result)) {
- *     console.log('Data:', result.value);
- *   } else {
- *     console.error('Error:', result.value);
- *   }
+ * const fetchData = async (): Promise<{ value: number }> => ({ value: 42 });
+ *
+ * const data$ = fromPromise(fetchData());
+ *
+ * const mut_history: { value: number }[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   data$.subscribe(
+ *     (result) => {
+ *       if (Result.isOk(result)) {
+ *         mut_history.push(result.value);
+ *       }
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
+ *
+ * assert.deepStrictEqual(mut_history, [{ value: 42 }]);
  * ```
  */
 export declare const fromPromise: <A, E = unknown>(promise: Readonly<Promise<A>>) => FromPromiseObservable<A, E>;

package/dist/core/create/from-promise.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"from-promise.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-promise.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EACxC,SAAS,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAC5B,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAA4C,CAAC"}
+{"version":3,"file":"from-promise.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-promise.mts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EACxC,SAAS,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAC5B,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAA4C,CAAC"}

package/dist/core/create/from-promise.mjs

@@ -13,15 +13,37 @@ import { RootObservableClass } from '../class/root-observable-class.mjs';
  *
  * @example
  * ```ts
- * const data$ = fromPromise(fetch('/api/data').then((r) => r.json()));
+ * //  Timeline:
+ * //
+ * //  promise     [pending...]  -> resolved/rejected
+ * //  data$                     Ok(value) or Err(error)
+ * //
+ * //  Explanation:
+ * //  - fromPromise converts a Promise into an observable
+ * //  - Emits a Result type: Ok(value) on success, Err(error) on failure
+ * //  - Completes after emitting the result
+ * //  - Useful for integrating async operations into reactive flows
  *
- * data$.subscribe((result) => {
- *   if (Result.isOk(result)) {
- *     console.log('Data:', result.value);
- *   } else {
- *     console.error('Error:', result.value);
- *   }
+ * const fetchData = async (): Promise<{ value: number }> => ({ value: 42 });
+ *
+ * const data$ = fromPromise(fetchData());
+ *
+ * const mut_history: { value: number }[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   data$.subscribe(
+ *     (result) => {
+ *       if (Result.isOk(result)) {
+ *         mut_history.push(result.value);
+ *       }
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
  * });
+ *
+ * assert.deepStrictEqual(mut_history, [{ value: 42 }]);
  * ```
  */
 const fromPromise = (promise) => new FromPromiseObservableClass(promise);

package/dist/core/create/from-promise.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"from-promise.mjs","sources":["../../../src/core/create/from-promise.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACI,MAAM,WAAW,GAAG,CACzB,OAA6B,KACG,IAAI,0BAA0B,CAAC,OAAO;AAExE,MAAM,0BACJ,SAAQ,mBAAiC,CAAA;AAGzC,IAAA,WAAA,CAAY,OAA6B,EAAA;QACvC,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEtC;AACG,aAAA,IAAI,CAAC,CAAC,KAAK,KAAI;YACd,IAAI,IAAI,CAAC,WAAW;gBAAE;YAEtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACpC,QAAA,CAAC;AACA,aAAA,KAAK,CAAC,CAAC,KAAc,KAAI;YACxB,IAAI,IAAI,CAAC,WAAW;gBAAE;AAEtB,YAAA,IAAI,CAAC,WAAW,CACd,MAAM,CAAC,GAAG;;YAER,KAAU,CACX,CACF;AACH,QAAA,CAAC;aACA,OAAO,CAAC,MAAK;YACZ,IAAI,CAAC,QAAQ,EAAE;AACjB,QAAA,CAAC,CAAC;IACN;AACD;;;;"}
+{"version":3,"file":"from-promise.mjs","sources":["../../../src/core/create/from-promise.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CG;AACI,MAAM,WAAW,GAAG,CACzB,OAA6B,KACG,IAAI,0BAA0B,CAAC,OAAO;AAExE,MAAM,0BACJ,SAAQ,mBAAiC,CAAA;AAGzC,IAAA,WAAA,CAAY,OAA6B,EAAA;QACvC,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEtC;AACG,aAAA,IAAI,CAAC,CAAC,KAAK,KAAI;YACd,IAAI,IAAI,CAAC,WAAW;gBAAE;YAEtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACpC,QAAA,CAAC;AACA,aAAA,KAAK,CAAC,CAAC,KAAc,KAAI;YACxB,IAAI,IAAI,CAAC,WAAW;gBAAE;AAEtB,YAAA,IAAI,CAAC,WAAW,CACd,MAAM,CAAC,GAAG;;YAER,KAAU,CACX,CACF;AACH,QAAA,CAAC;aACA,OAAO,CAAC,MAAK;YACZ,IAAI,CAAC,QAAQ,EAAE;AACjB,QAAA,CAAC,CAAC;IACN;AACD;;;;"}

package/dist/core/create/from-subscribable.d.mts

@@ -1,3 +1,61 @@
 import { type FromSubscribableObservable, type Subscribable } from '../types/index.mjs';
+/**
+ * Converts any subscribable object into a SynState Observable.
+ * Works with objects that have a subscribe(onNext, onError, onComplete) method.
+ *
+ * @template A - The type of values from the subscribable
+ * @template E - The type of errors from the subscribable
+ * @param subscribable - An object with a subscribe method
+ * @returns An observable that wraps values in Result type
+ *
+ * @example
+ * ```ts
+ * //  Explanation:
+ * //  - fromSubscribable converts any subscribable object into a SynState Observable
+ * //  - Works with objects that have a subscribe(onNext, onError, onComplete) method
+ * //  - Wraps values in Result type for error handling
+ * //  - Useful for integrating with other reactive libraries or custom subscribables
+ *
+ * // Example: Converting a custom subscribable
+ * const customSubscribable = {
+ *   subscribe: (
+ *     onNext: (value: number) => void,
+ *     _onError?: (error: unknown) => void,
+ *     onComplete?: () => void,
+ *   ) => {
+ *     setTimeout(() => {
+ *       onNext(1);
+ *
+ *       onNext(2);
+ *
+ *       onNext(3);
+ *
+ *       onComplete?.();
+ *     }, 0);
+ *
+ *     return { unsubscribe: () => {} };
+ *   },
+ * };
+ *
+ * const observable$ = fromSubscribable<number>(customSubscribable);
+ *
+ * const mut_history: number[] = [];
+ *
+ * await new Promise<void>((resolve) => {
+ *   observable$.subscribe(
+ *     (result) => {
+ *       if (Result.isOk(result)) {
+ *         mut_history.push(result.value);
+ *       }
+ *     },
+ *     () => {
+ *       resolve();
+ *     },
+ *   );
+ * });
+ *
+ * assert.deepStrictEqual(mut_history, [1, 2, 3]);
+ * ```
+ */
 export declare const fromSubscribable: <A, E = unknown>(subscribable: Subscribable<A>) => FromSubscribableObservable<A, E>;
 //# sourceMappingURL=from-subscribable.d.mts.map

package/dist/core/create/from-subscribable.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"from-subscribable.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-subscribable.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAC7C,cAAc,YAAY,CAAC,CAAC,CAAC,KAC5B,0BAA0B,CAAC,CAAC,EAAE,CAAC,CACiB,CAAC"}
+{"version":3,"file":"from-subscribable.d.mts","sourceRoot":"","sources":["../../../src/core/create/from-subscribable.mts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAC7C,cAAc,YAAY,CAAC,CAAC,CAAC,KAC5B,0BAA0B,CAAC,CAAC,EAAE,CAAC,CACiB,CAAC"}