@typed/fx 2.0.0-beta.5 → 2.0.0-beta.7

package/dist/RefSubject/RefHashSet.js

@@ -20,7 +20,7 @@ import * as RefSubject from "./RefSubject.js";
  * and cleanup; source failures and services stay on reads and pushes.
  *
  * @since 1.18.0
- * @category constructors
+ * @category Constructors
  */
 export function make(initial) {
     return RefSubject.make(initial, { eq: equals });
@@ -42,7 +42,7 @@ export function make(initial) {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const add = dual(2, function add(ref, value) {
     return RefSubject.update(ref, HashSet.add(value));
@@ -61,7 +61,7 @@ export const add = dual(2, function add(ref, value) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const remove = dual(2, function remove(ref, value) {
     return RefSubject.update(ref, HashSet.remove(value));
@@ -80,7 +80,7 @@ export const remove = dual(2, function remove(ref, value) {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const clear = (ref) => RefSubject.update(ref, () => HashSet.empty());
 /**
@@ -97,7 +97,7 @@ export const clear = (ref) => RefSubject.update(ref, () => HashSet.empty());
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const union = dual(2, function union(ref, that) {
     return RefSubject.update(ref, HashSet.union(that));
@@ -116,7 +116,7 @@ export const union = dual(2, function union(ref, that) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const intersection = dual(2, function intersection(ref, that) {
     return RefSubject.update(ref, HashSet.intersection(that));
@@ -135,7 +135,7 @@ export const intersection = dual(2, function intersection(ref, that) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const difference = dual(2, function difference(ref, that) {
     return RefSubject.update(ref, HashSet.difference(that));
@@ -153,7 +153,7 @@ export const difference = dual(2, function difference(ref, that) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed HashSet and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const filter = dual(2, function filter(ref, predicate) {
     return RefSubject.update(ref, HashSet.filter(predicate));
@@ -171,7 +171,7 @@ export const filter = dual(2, function filter(ref, predicate) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed HashSet and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const map = dual(2, function map(ref, f) {
     return RefSubject.update(ref, HashSet.map(f));
@@ -193,7 +193,7 @@ export const map = dual(2, function map(ref, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const size = (ref) => RefSubject.map(ref, HashSet.size);
 /**
@@ -210,7 +210,7 @@ export const size = (ref) => RefSubject.map(ref, HashSet.size);
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const isEmpty = (ref) => RefSubject.map(ref, HashSet.isEmpty);
 /**
@@ -227,7 +227,7 @@ export const isEmpty = (ref) => RefSubject.map(ref, HashSet.isEmpty);
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const isNonEmpty = (ref) => RefSubject.map(ref, (s) => !HashSet.isEmpty(s));
 /**
@@ -244,7 +244,7 @@ export const isNonEmpty = (ref) => RefSubject.map(ref, (s) => !HashSet.isEmpty(s
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const has = dual(2, function has(ref, value) {
     return RefSubject.map(ref, HashSet.has(value));
@@ -263,7 +263,7 @@ export const has = dual(2, function has(ref, value) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const some = dual(2, function some(ref, predicate) {
     return RefSubject.map(ref, HashSet.some(predicate));
@@ -282,7 +282,7 @@ export const some = dual(2, function some(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const every = dual(2, function every(ref, predicate) {
     return RefSubject.map(ref, HashSet.every(predicate));
@@ -301,7 +301,7 @@ export const every = dual(2, function every(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const isSubset = dual(2, function isSubset(ref, that) {
     return RefSubject.map(ref, HashSet.isSubset(that));
@@ -320,7 +320,7 @@ export const isSubset = dual(2, function isSubset(ref, that) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const mapValues = dual(2, function mapValues(ref, f) {
     return RefSubject.map(ref, HashSet.map(f));
@@ -339,7 +339,7 @@ export const mapValues = dual(2, function mapValues(ref, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const filterValues = dual(2, function filterValues(ref, predicate) {
     return RefSubject.map(ref, HashSet.filter(predicate));
@@ -358,7 +358,7 @@ export const filterValues = dual(2, function filterValues(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const reduce = dual(3, function reduce(ref, b, f) {
     return RefSubject.map(ref, HashSet.reduce(b, f));
@@ -377,6 +377,6 @@ export const reduce = dual(3, function reduce(ref, b, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const values = (ref) => RefSubject.map(ref, (s) => Array.from(s));

package/dist/RefSubject/RefIterable.d.ts

@@ -21,7 +21,7 @@ import * as RefSubject from "./RefSubject.js";
  * services, interruption, and Scope requirements expressed by its members.
  *
  * @since 1.18.0
- * @category models
+ * @category State models
  */
 export interface RefIterable<in out A, in out E = never, out R = never> extends RefSubject.RefSubject<Iterable<A>, E, R> {
 }
@@ -39,7 +39,7 @@ export interface RefIterable<in out A, in out E = never, out R = never> extends
  * and cleanup; source failures and services stay on reads and pushes.
  *
  * @since 1.18.0
- * @category constructors
+ * @category Constructors
  */
 export declare function make<A, E = never, R = never>(initial: Iterable<A> | Effect.Effect<Iterable<A>, E, R> | Fx.Fx<Iterable<A>, E, R>): Effect.Effect<RefIterable<A, E>, never, R | Scope.Scope>;
 /**
@@ -56,7 +56,7 @@ export declare function make<A, E = never, R = never>(initial: Iterable<A> | Eff
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const prepend: {
     <A>(value: A): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -76,7 +76,7 @@ export declare const prepend: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const prependAll: {
     <A>(value: Iterable<A>): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -96,7 +96,7 @@ export declare const prependAll: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const append: {
     <A>(value: A): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -116,7 +116,7 @@ export declare const append: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const appendAll: {
     <A>(value: Iterable<A>): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -136,7 +136,7 @@ export declare const appendAll: {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const drop: {
     (n: number): <A, E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -156,7 +156,7 @@ export declare const drop: {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const take: {
     (n: number): <A, E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -176,7 +176,7 @@ export declare const take: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const takeWhile: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -195,7 +195,7 @@ export declare const takeWhile: {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const filter: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -214,7 +214,7 @@ export declare const filter: {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const map: {
     <A>(f: (a: A, index: number) => A): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -234,7 +234,7 @@ export declare const map: {
  * committed value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const dedupeAdjacent: <A, E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
 /**
@@ -251,7 +251,7 @@ export declare const dedupeAdjacent: <A, E, R>(ref: RefIterable<A, E, R>) => Eff
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const intersperse: {
     <A>(middle: A): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -271,7 +271,7 @@ export declare const intersperse: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const repeat: {
     (n: number): <A, E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -291,7 +291,7 @@ export declare const repeat: {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const flatMap: {
     <A>(f: (a: A, index: number) => Iterable<A>): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -310,7 +310,7 @@ export declare const flatMap: {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const filterMap: {
     <A>(f: (a: A, index: number) => Option.Option<A>): <E, R>(ref: RefIterable<A, E, R>) => Effect.Effect<Iterable<A>, E, R>;
@@ -329,7 +329,7 @@ export declare const filterMap: {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export declare const getSomes: <A, E, R>(ref: RefIterable<Option.Option<A>, E, R>) => Effect.Effect<Iterable<Option.Option<A>>, E, R>;
 /**
@@ -346,7 +346,7 @@ export declare const getSomes: <A, E, R>(ref: RefIterable<Option.Option<A>, E, R
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export declare const isEmpty: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<boolean, E, R>;
 /**
@@ -363,7 +363,7 @@ export declare const isEmpty: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const size: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<number, E, R>;
 /**
@@ -380,7 +380,7 @@ export declare const size: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Co
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const mapValues: {
     <A, B>(f: (a: A, index: number) => B): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<Iterable<B>, E, R>;
@@ -400,7 +400,7 @@ export declare const mapValues: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const filterValues: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<Iterable<A>, E, R>;
@@ -420,7 +420,7 @@ export declare const filterValues: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const groupBy: {
     <A>(f: (a: A) => string): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<Record<string, Array<A>>, E, R>;
@@ -440,7 +440,7 @@ export declare const groupBy: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const reduce: {
     <A, B>(b: B, f: (b: B, a: A, index: number) => B): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<B, E, R>;
@@ -460,7 +460,7 @@ export declare const reduce: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export declare const some: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<boolean, E, R>;
@@ -480,7 +480,7 @@ export declare const some: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export declare const contains: {
     <A>(value: A): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<boolean, E, R>;
@@ -500,7 +500,7 @@ export declare const contains: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const countBy: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<number, E, R>;
@@ -520,7 +520,7 @@ export declare const countBy: {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export declare const toArray: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Computed<Array<A>, E, R>;
 /**
@@ -537,7 +537,7 @@ export declare const toArray: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export declare const head: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Filtered<A, E, R>;
 /**
@@ -554,7 +554,7 @@ export declare const head: <A, E, R>(ref: RefIterable<A, E, R>) => RefSubject.Fi
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export declare const findFirst: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Filtered<A, E, R>;
@@ -574,7 +574,7 @@ export declare const findFirst: {
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export declare const findLast: {
     <A>(predicate: (a: A) => boolean): <E, R>(ref: RefIterable<A, E, R>) => RefSubject.Filtered<A, E, R>;

package/dist/RefSubject/RefIterable.js

@@ -22,7 +22,7 @@ import * as RefSubject from "./RefSubject.js";
  * and cleanup; source failures and services stay on reads and pushes.
  *
  * @since 1.18.0
- * @category constructors
+ * @category Constructors
  */
 export function make(initial) {
     return RefSubject.make(initial, { eq: equals });
@@ -44,7 +44,7 @@ export function make(initial) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const prepend = dual(2, function prepend(ref, value) {
     return RefSubject.update(ref, Iterable.prepend(value));
@@ -63,7 +63,7 @@ export const prepend = dual(2, function prepend(ref, value) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const prependAll = dual(2, function prependAll(ref, value) {
     return RefSubject.update(ref, Iterable.prependAll(value));
@@ -82,7 +82,7 @@ export const prependAll = dual(2, function prependAll(ref, value) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const append = dual(2, function append(ref, value) {
     return RefSubject.update(ref, Iterable.append(value));
@@ -101,7 +101,7 @@ export const append = dual(2, function append(ref, value) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const appendAll = dual(2, function appendAll(ref, value) {
     return RefSubject.update(ref, Iterable.appendAll(value));
@@ -120,7 +120,7 @@ export const appendAll = dual(2, function appendAll(ref, value) {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const drop = dual(2, function drop(ref, n) {
     return RefSubject.update(ref, Iterable.drop(n));
@@ -139,7 +139,7 @@ export const drop = dual(2, function drop(ref, n) {
  * It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const take = dual(2, function take(ref, n) {
     return RefSubject.update(ref, Iterable.take(n));
@@ -158,7 +158,7 @@ export const take = dual(2, function take(ref, n) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const takeWhile = dual(2, function takeWhile(ref, predicate) {
     return RefSubject.update(ref, Iterable.takeWhile(predicate));
@@ -176,7 +176,7 @@ export const takeWhile = dual(2, function takeWhile(ref, predicate) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const filter = dual(2, function filter(ref, predicate) {
     return RefSubject.update(ref, Iterable.filter(predicate));
@@ -194,7 +194,7 @@ export const filter = dual(2, function filter(ref, predicate) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const map = dual(2, function map(ref, f) {
     return RefSubject.update(ref, Iterable.map(f));
@@ -213,7 +213,7 @@ export const map = dual(2, function map(ref, f) {
  * committed value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const dedupeAdjacent = (ref) => RefSubject.update(ref, Iterable.dedupeAdjacent);
 /**
@@ -230,7 +230,7 @@ export const dedupeAdjacent = (ref) => RefSubject.update(ref, Iterable.dedupeAdj
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const intersperse = dual(2, function intersperse(ref, middle) {
     return RefSubject.update(ref, Iterable.intersperse(middle));
@@ -249,7 +249,7 @@ export const intersperse = dual(2, function intersperse(ref, middle) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const repeat = dual(2, function repeat(ref, n) {
     return RefSubject.update(ref, Iterable.repeat(n));
@@ -268,7 +268,7 @@ export const repeat = dual(2, function repeat(ref, n) {
  * value. It acquires no resource; failures and services remain those of the source ref.
  *
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const flatMap = dual(2, function flatMap(ref, f) {
     return RefSubject.update(ref, Iterable.flatMap(f));
@@ -286,7 +286,7 @@ export const flatMap = dual(2, function flatMap(ref, f) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const filterMap = dual(2, function filterMap(ref, f) {
     return RefSubject.update(ref, Iterable.filterMap((a, index) => Option.match(f(a, index), {
@@ -307,7 +307,7 @@ export const filterMap = dual(2, function filterMap(ref, f) {
  * The Effect starts when run, participates in the source ref's serialized update boundary, and
  * acquires no resource. It returns the committed Iterable and retains the ref's E and R channels.
  * @since 1.18.0
- * @category combinators
+ * @category State updates
  */
 export const getSomes = (ref) => RefSubject.update(ref, (iter) => Iterable.getSomes(iter));
 // ========================================
@@ -327,7 +327,7 @@ export const getSomes = (ref) => RefSubject.update(ref, (iter) => Iterable.getSo
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const isEmpty = (ref) => RefSubject.map(ref, Iterable.isEmpty);
 /**
@@ -344,7 +344,7 @@ export const isEmpty = (ref) => RefSubject.map(ref, Iterable.isEmpty);
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const size = (ref) => RefSubject.map(ref, Iterable.size);
 /**
@@ -361,7 +361,7 @@ export const size = (ref) => RefSubject.map(ref, Iterable.size);
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const mapValues = dual(2, function mapValues(ref, f) {
     return RefSubject.map(ref, Iterable.map(f));
@@ -380,7 +380,7 @@ export const mapValues = dual(2, function mapValues(ref, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const filterValues = dual(2, function filterValues(ref, predicate) {
     return RefSubject.map(ref, Iterable.filter(predicate));
@@ -399,7 +399,7 @@ export const filterValues = dual(2, function filterValues(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const groupBy = dual(2, function groupBy(ref, f) {
     return RefSubject.map(ref, Iterable.groupBy(f));
@@ -418,7 +418,7 @@ export const groupBy = dual(2, function groupBy(ref, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const reduce = dual(3, function reduce(ref, b, f) {
     return RefSubject.map(ref, Iterable.reduce(b, f));
@@ -437,7 +437,7 @@ export const reduce = dual(3, function reduce(ref, b, f) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const some = dual(2, function some(ref, predicate) {
     return RefSubject.map(ref, Iterable.some(predicate));
@@ -456,7 +456,7 @@ export const some = dual(2, function some(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category State predicates
  */
 export const contains = dual(2, function contains(ref, value) {
     return RefSubject.map(ref, Iterable.contains(value));
@@ -475,7 +475,7 @@ export const contains = dual(2, function contains(ref, value) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const countBy = dual(2, function countBy(ref, predicate) {
     return RefSubject.map(ref, Iterable.countBy(predicate));
@@ -494,7 +494,7 @@ export const countBy = dual(2, function countBy(ref, predicate) {
  * observation follows later pushes and its observing Scope owns subscription cleanup.
  *
  * @since 1.18.0
- * @category computed
+ * @category Derived queries
  */
 export const toArray = (ref) => RefSubject.map(ref, (iter) => Array.from(iter));
 // ========================================
@@ -514,7 +514,7 @@ export const toArray = (ref) => RefSubject.map(ref, (iter) => Array.from(iter));
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export const head = (ref) => RefSubject.filterMap(ref, Iterable.head);
 /**
@@ -531,7 +531,7 @@ export const head = (ref) => RefSubject.filterMap(ref, Iterable.head);
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export const findFirst = dual(2, function findFirst(ref, predicate) {
     return RefSubject.filterMap(ref, Iterable.findFirst(predicate));
@@ -550,7 +550,7 @@ export const findFirst = dual(2, function findFirst(ref, predicate) {
  * while absent; the observing Scope owns and finalizes its Fx subscription.
  *
  * @since 1.18.0
- * @category filtered
+ * @category Optional queries
  */
 export const findLast = dual(2, function findLast(ref, predicate) {
     return RefSubject.filterMap(ref, Iterable.findLast(predicate));