effect 4.0.0-beta.5 → 4.0.0-beta.50

package/dist/unstable/process/ChildProcessSpawner.d.ts

@@ -7,12 +7,12 @@
  * @since 4.0.0
  */
 import * as Brand from "../../Brand.ts";
-import type * as Effect from "../../Effect.ts";
+import * as Context from "../../Context.ts";
+import * as Effect from "../../Effect.ts";
 import type * as PlatformError from "../../PlatformError.ts";
 import type * as Scope from "../../Scope.ts";
-import * as ServiceMap from "../../ServiceMap.ts";
 import type * as Sink from "../../Sink.ts";
-import type * as Stream from "../../Stream.ts";
+import * as Stream from "../../Stream.ts";
 import type { Command, KillOptions } from "./ChildProcess.ts";
 /**
  * @since 4.0.0
@@ -34,6 +34,18 @@ export type ProcessId = Brand.Branded<number, "ProcessId">;
  * @category Constructors
  */
 export declare const ProcessId: Brand.Constructor<ProcessId>;
+/**
+ * An `Effect` that adds an unrefed child process back into the parent
+ * process's reference count.
+ *
+ * This value is returned by `ChildProcessHandle.unref` and can be run later to
+ * restore the default behavior where the child process keeps the parent
+ * process alive.
+ *
+ * @since 4.0.0
+ * @category Models
+ */
+export type Reref = Effect.Effect<void, PlatformError.PlatformError>;
 declare const HandleTypeId = "~effect/ChildProcessSpawner/ChildProcessHandle";
 /**
  * A handle to a running child process.
@@ -69,10 +81,16 @@ export interface ChildProcessHandle {
     readonly stdin: Sink.Sink<void, Uint8Array, never, PlatformError.PlatformError>;
     /**
      * The standard output stream for the child process.
+     *
+     * Note: Using alongside `all` may cause interleaving of output and unexpected
+     * results.
      */
     readonly stdout: Stream.Stream<Uint8Array, PlatformError.PlatformError>;
     /**
      * The standard error stream for the child process.
+     *
+     * Note: Using alongside `all` may cause interleaving of output and unexpected
+     * results.
      */
     readonly stderr: Stream.Stream<Uint8Array, PlatformError.PlatformError>;
     /**
@@ -96,6 +114,37 @@ export interface ChildProcessHandle {
      * `Stream`.
      */
     readonly getOutputFd: (fd: number) => Stream.Stream<Uint8Array, PlatformError.PlatformError>;
+    /**
+     * Allows the parent process to exit independently of this child process.
+     *
+     * Running this `Effect` removes this child process from the parent process's
+     * reference count, so the parent process is allowed to exit without waiting
+     * for the child process to finish.
+     *
+     * The returned `Reref` effect adds the child process back into the parent
+     * process's reference count when run, restoring the default behavior.
+     *
+     * This is the only supported way to re-reference a child process after it
+     * has been unrefed.
+     *
+     * @example
+     * ```ts
+     * import { NodeServices } from "@effect/platform-node"
+     * import { Effect } from "effect"
+     * import { ChildProcess } from "effect/unstable/process"
+     *
+     * const program = Effect.gen(function*() {
+     *   const handle = yield* ChildProcess.make`./server`
+     *   const reref = yield* handle.unref
+     *
+     *   yield* Effect.sleep("1 second")
+     *
+     *   yield* reref
+     *   return yield* handle.exitCode
+     * }).pipe(Effect.scoped, Effect.provide(NodeServices.layer))
+     * ```
+     */
+    readonly unref: Effect.Effect<Reref, PlatformError.PlatformError>;
 }
 /**
  * Constructs a new `ChildProcessHandle`.
@@ -105,23 +154,55 @@ export interface ChildProcessHandle {
  */
 export declare const makeHandle: (params: Omit<ChildProcessHandle, typeof HandleTypeId>) => ChildProcessHandle;
 /**
- * Service interface for spawning child processes.
+ * Create a new `ChildProcessSpawner` service from a `spawn` funciton
  *
  * @since 4.0.0
  * @category Models
  */
-export interface ChildProcessSpawner {
+export declare const make: (spawn: ChildProcessSpawner["Service"]["spawn"]) => ChildProcessSpawner["Service"];
+declare const ChildProcessSpawner_base: Context.ServiceClass<ChildProcessSpawner, "effect/process/ChildProcessSpawner", {
     /**
      * Spawn a command and return a handle for interaction.
      */
-    readonly spawn: (command: Command) => Effect.Effect<ChildProcessHandle, PlatformError.PlatformError, Scope.Scope>;
-}
+    spawn(command: Command): Effect.Effect<ChildProcessHandle, PlatformError.PlatformError, Scope.Scope>;
+    /**
+     * Run a command and return its exit code.
+     */
+    exitCode(command: Command): Effect.Effect<ExitCode, PlatformError.PlatformError>;
+    /**
+     * Stream the output of a command as strings. Optionally include stderr output
+     * interleaved with stdout.
+     */
+    streamString(command: Command, options?: {
+        readonly includeStderr?: boolean | undefined;
+    }): Stream.Stream<string, PlatformError.PlatformError>;
+    /**
+     * Stream the output of a command as lines. Optionally include stderr output
+     * interleaved with stdout.
+     */
+    streamLines(command: Command, options?: {
+        readonly includeStderr?: boolean | undefined;
+    }): Stream.Stream<string, PlatformError.PlatformError>;
+    /**
+     * Run a command and return the lines of its output as an array of strings.
+     */
+    lines(command: Command, options?: {
+        readonly includeStderr?: boolean | undefined;
+    }): Effect.Effect<Array<string>, PlatformError.PlatformError>;
+    /**
+     * Run a command and return its output as a string.
+     */
+    string(command: Command, options?: {
+        readonly includeStderr?: boolean | undefined;
+    }): Effect.Effect<string, PlatformError.PlatformError>;
+}>;
 /**
  * Service tag for child process spawning.
  *
  * @since 4.0.0
  * @category Service
  */
-export declare const ChildProcessSpawner: ServiceMap.Service<ChildProcessSpawner, ChildProcessSpawner>;
+export declare class ChildProcessSpawner extends ChildProcessSpawner_base {
+}
 export {};
 //# sourceMappingURL=ChildProcessSpawner.d.ts.map

package/dist/unstable/process/ChildProcessSpawner.d.ts.map

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

package/dist/unstable/process/ChildProcessSpawner.js

@@ -7,8 +7,10 @@
  * @since 4.0.0
  */
 import * as Brand from "../../Brand.js";
+import * as Context from "../../Context.js";
+import * as Effect from "../../Effect.js";
 import * as Inspectable from "../../Inspectable.js";
-import * as ServiceMap from "../../ServiceMap.js";
+import * as Stream from "../../Stream.js";
 /**
  * @since 4.0.0
  * @category Constructors
@@ -37,11 +39,29 @@ const HandleProto = {
  * @category Constructors
  */
 export const makeHandle = params => Object.assign(Object.create(HandleProto), params);
+/**
+ * Create a new `ChildProcessSpawner` service from a `spawn` funciton
+ *
+ * @since 4.0.0
+ * @category Models
+ */
+export const make = spawn => {
+  const streamString = (command, options) => spawn(command).pipe(Effect.map(handle => Stream.decodeText(options?.includeStderr === true ? handle.all : handle.stdout)), Stream.unwrap);
+  const streamLines = (command, options) => Stream.splitLines(streamString(command, options));
+  return ChildProcessSpawner.of({
+    spawn,
+    exitCode: command => Effect.scoped(Effect.flatMap(spawn(command), handle => handle.exitCode)),
+    streamString,
+    streamLines,
+    lines: (command, options) => Stream.runCollect(streamLines(command, options)),
+    string: (command, options) => Stream.mkString(streamString(command, options))
+  });
+};
 /**
  * Service tag for child process spawning.
  *
  * @since 4.0.0
  * @category Service
  */
-export const ChildProcessSpawner = /*#__PURE__*/ServiceMap.Service("effect/process/ChildProcessSpawner");
+export class ChildProcessSpawner extends /*#__PURE__*/Context.Service()("effect/process/ChildProcessSpawner") {}
 //# sourceMappingURL=ChildProcessSpawner.js.map

package/dist/unstable/process/ChildProcessSpawner.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcessSpawner.js","names":["Brand","Inspectable","ServiceMap","ExitCode","nominal","ProcessId","HandleTypeId","HandleProto","BaseProto","toJSON","_id","pid","makeHandle","params","Object","assign","create","ChildProcessSpawner","Service"],"sources":["../../../src/unstable/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;AAQA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AAEvC,OAAO,KAAKC,WAAW,MAAM,sBAAsB;AAGnD,OAAO,KAAKC,UAAU,MAAM,qBAAqB;AAWjD;;;;AAIA,OAAO,MAAMC,QAAQ,gBAAgCH,KAAK,CAACI,OAAO,EAAY;AAQ9E;;;;AAIA,OAAO,MAAMC,SAAS,gBAAiCL,KAAK,CAACI,OAAO,EAAa;AAEjF,MAAME,YAAY,GAAG,gDAAgD;AAiErE,MAAMC,WAAW,GAAG;EAClB,CAACD,YAAY,GAAGA,YAAY;EAC5B,GAAGL,WAAW,CAACO,SAAS;EACxBC,MAAMA,CAAA;IACJ,OAAO;MAAEC,GAAG,EAAE,oBAAoB;MAAEC,GAAG,EAAE,IAAI,CAACA;IAAG,CAAE;EACrD;CACD;AAED;;;;;;AAMA,OAAO,MAAMC,UAAU,GAAIC,MAAqD,IAC9EC,MAAM,CAACC,MAAM,CAACD,MAAM,CAACE,MAAM,CAACT,WAAW,CAAC,EAAEM,MAAM,CAAC;AAiBnD;;;;;;AAMA,OAAO,MAAMI,mBAAmB,gBAG5Bf,UAAU,CAACgB,OAAO,CAAC,oCAAoC,CAAC","ignoreList":[]}
+{"version":3,"file":"ChildProcessSpawner.js","names":["Brand","Context","Effect","Inspectable","Stream","ExitCode","nominal","ProcessId","HandleTypeId","HandleProto","BaseProto","toJSON","_id","pid","makeHandle","params","Object","assign","create","make","spawn","streamString","command","options","pipe","map","handle","decodeText","includeStderr","all","stdout","unwrap","streamLines","splitLines","ChildProcessSpawner","of","exitCode","scoped","flatMap","lines","runCollect","string","mkString","Service"],"sources":["../../../src/unstable/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;AAQA,OAAO,KAAKA,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,WAAW,MAAM,sBAAsB;AAInD,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AASzC;;;;AAIA,OAAO,MAAMC,QAAQ,gBAAgCL,KAAK,CAACM,OAAO,EAAY;AAQ9E;;;;AAIA,OAAO,MAAMC,SAAS,gBAAiCP,KAAK,CAACM,OAAO,EAAa;AAejF,MAAME,YAAY,GAAG,gDAAgD;AAsGrE,MAAMC,WAAW,GAAG;EAClB,CAACD,YAAY,GAAGA,YAAY;EAC5B,GAAGL,WAAW,CAACO,SAAS;EACxBC,MAAMA,CAAA;IACJ,OAAO;MAAEC,GAAG,EAAE,oBAAoB;MAAEC,GAAG,EAAE,IAAI,CAACA;IAAG,CAAE;EACrD;CACD;AAED;;;;;;AAMA,OAAO,MAAMC,UAAU,GAAIC,MAAqD,IAC9EC,MAAM,CAACC,MAAM,CAACD,MAAM,CAACE,MAAM,CAACT,WAAW,CAAC,EAAEM,MAAM,CAAC;AAEnD;;;;;;AAMA,OAAO,MAAMI,IAAI,GAAIC,KAA8C,IAAoC;EACrG,MAAMC,YAAY,GAAkDA,CAACC,OAAO,EAAEC,OAAO,KACnFH,KAAK,CAACE,OAAO,CAAC,CAACE,IAAI,CACjBtB,MAAM,CAACuB,GAAG,CAAEC,MAAM,IAChBtB,MAAM,CAACuB,UAAU,CACfJ,OAAO,EAAEK,aAAa,KAAK,IAAI,GAAGF,MAAM,CAACG,GAAG,GAAGH,MAAM,CAACI,MAAM,CAC7D,CACF,EACD1B,MAAM,CAAC2B,MAAM,CACd;EACH,MAAMC,WAAW,GAAkDA,CAACV,OAAO,EAAEC,OAAO,KAClFnB,MAAM,CAAC6B,UAAU,CAACZ,YAAY,CAACC,OAAO,EAAEC,OAAO,CAAC,CAAC;EAEnD,OAAOW,mBAAmB,CAACC,EAAE,CAAC;IAC5Bf,KAAK;IACLgB,QAAQ,EAAGd,OAAO,IAAKpB,MAAM,CAACmC,MAAM,CAACnC,MAAM,CAACoC,OAAO,CAAClB,KAAK,CAACE,OAAO,CAAC,EAAGI,MAAM,IAAKA,MAAM,CAACU,QAAQ,CAAC,CAAC;IACjGf,YAAY;IACZW,WAAW;IACXO,KAAK,EAAEA,CAACjB,OAAO,EAAEC,OAAO,KAAKnB,MAAM,CAACoC,UAAU,CAACR,WAAW,CAACV,OAAO,EAAEC,OAAO,CAAC,CAAC;IAC7EkB,MAAM,EAAEA,CAACnB,OAAO,EAAEC,OAAO,KAAKnB,MAAM,CAACsC,QAAQ,CAACrB,YAAY,CAACC,OAAO,EAAEC,OAAO,CAAC;GAC7E,CAAC;AACJ,CAAC;AAED;;;;;;AAMA,OAAM,MAAOW,mBAAoB,sBAAQjC,OAAO,CAAC0C,OAAO,EA4CpD,CAAC,oCAAoC,CAAC","ignoreList":[]}

package/dist/unstable/reactivity/Atom.d.ts

@@ -3,6 +3,7 @@
  */
 import * as Arr from "../../Array.ts";
 import * as Cause from "../../Cause.ts";
+import * as Context from "../../Context.ts";
 import * as Duration from "../../Duration.ts";
 import * as Effect from "../../Effect.ts";
 import type { LazyArg } from "../../Function.ts";
@@ -13,7 +14,6 @@ import type { Pipeable } from "../../Pipeable.ts";
 import type { ReadonlyRecord } from "../../Record.ts";
 import * as Schema from "../../Schema.ts";
 import * as Scope from "../../Scope.ts";
-import * as ServiceMap from "../../ServiceMap.ts";
 import * as Stream from "../../Stream.ts";
 import * as SubscriptionRef from "../../SubscriptionRef.ts";
 import type { NoInfer } from "../../Types.ts";
@@ -40,10 +40,11 @@ export interface Atom<A> extends Pipeable, Inspectable.Inspectable {
     readonly [TypeId]: TypeId;
     readonly keepAlive: boolean;
     readonly lazy: boolean;
-    readonly read: (get: Context) => A;
+    readonly read: (get: AtomContext) => A;
     readonly refresh?: (f: <A>(atom: Atom<A>) => void) => void;
     readonly label?: readonly [name: string, stack: string];
     readonly idleTTL?: number;
+    readonly initialValueTarget?: Atom<A>;
 }
 /**
  * @since 4.0.0
@@ -92,35 +93,35 @@ export interface Writable<R, W = R> extends Atom<R> {
  * @since 4.0.0
  * @category context
  */
-export interface Context {
+export interface AtomContext {
     <A>(atom: Atom<A>): A;
-    get<A>(this: Context, atom: Atom<A>): A;
-    result<A, E>(this: Context, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
+    get<A>(this: AtomContext, atom: Atom<A>): A;
+    result<A, E>(this: AtomContext, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
         readonly suspendOnWaiting?: boolean | undefined;
     }): Effect.Effect<A, E>;
-    resultOnce<A, E>(this: Context, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
+    resultOnce<A, E>(this: AtomContext, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
         readonly suspendOnWaiting?: boolean | undefined;
     }): Effect.Effect<A, E>;
-    once<A>(this: Context, atom: Atom<A>): A;
-    addFinalizer(this: Context, f: () => void): void;
-    mount<A>(this: Context, atom: Atom<A>): void;
-    refresh<A>(this: Context, atom: Atom<A>): void;
-    refreshSelf(this: Context): void;
-    self<A>(this: Context): Option.Option<A>;
-    setSelf<A>(this: Context, a: A): void;
-    set<R, W>(this: Context, atom: Writable<R, W>, value: W): void;
-    setResult<A, E, W>(this: Context, atom: Writable<AsyncResult.AsyncResult<A, E>, W>, value: W): Effect.Effect<A, E>;
-    some<A>(this: Context, atom: Atom<Option.Option<A>>): Effect.Effect<A>;
-    someOnce<A>(this: Context, atom: Atom<Option.Option<A>>): Effect.Effect<A>;
-    stream<A>(this: Context, atom: Atom<A>, options?: {
+    once<A>(this: AtomContext, atom: Atom<A>): A;
+    addFinalizer(this: AtomContext, f: () => void): void;
+    mount<A>(this: AtomContext, atom: Atom<A>): void;
+    refresh<A>(this: AtomContext, atom: Atom<A>): void;
+    refreshSelf(this: AtomContext): void;
+    self<A>(this: AtomContext): Option.Option<A>;
+    setSelf<A>(this: AtomContext, a: A): void;
+    set<R, W>(this: AtomContext, atom: Writable<R, W>, value: W): void;
+    setResult<A, E, W>(this: AtomContext, atom: Writable<AsyncResult.AsyncResult<A, E>, W>, value: W): Effect.Effect<A, E>;
+    some<A>(this: AtomContext, atom: Atom<Option.Option<A>>): Effect.Effect<A>;
+    someOnce<A>(this: AtomContext, atom: Atom<Option.Option<A>>): Effect.Effect<A>;
+    stream<A>(this: AtomContext, atom: Atom<A>, options?: {
         readonly withoutInitialValue?: boolean;
         readonly bufferSize?: number;
     }): Stream.Stream<A>;
-    streamResult<A, E>(this: Context, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
+    streamResult<A, E>(this: AtomContext, atom: Atom<AsyncResult.AsyncResult<A, E>>, options?: {
         readonly withoutInitialValue?: boolean;
         readonly bufferSize?: number;
     }): Stream.Stream<A, E>;
-    subscribe<A>(this: Context, atom: Atom<A>, f: (_: A) => void, options?: {
+    subscribe<A>(this: AtomContext, atom: Atom<A>, f: (_: A) => void, options?: {
         readonly immediate?: boolean;
     }): void;
     readonly registry: Registry.AtomRegistry;
@@ -144,12 +145,12 @@ export declare const setIdleTTL: {
      * @since 4.0.0
      * @category combinators
      */
-    (duration: Duration.DurationInput): <A extends Atom<any>>(self: A) => A;
+    (duration: Duration.Input): <A extends Atom<any>>(self: A) => A;
     /**
      * @since 4.0.0
      * @category combinators
      */
-    <A extends Atom<any>>(self: A, duration: Duration.DurationInput): A;
+    <A extends Atom<any>>(self: A, duration: Duration.Input): A;
 };
 /**
  * @since 4.0.0
@@ -160,12 +161,12 @@ export declare const isWritable: <R, W>(atom: Atom<R>) => atom is Writable<R, W>
  * @since 4.0.0
  * @category constructors
  */
-export declare const readable: <A>(read: (get: Context) => A, refresh?: (f: <A_1>(atom: Atom<A_1>) => void) => void) => Atom<A>;
+export declare const readable: <A>(read: (get: AtomContext) => A, refresh?: (f: <A_1>(atom: Atom<A_1>) => void) => void) => Atom<A>;
 /**
  * @since 4.0.0
  * @category constructors
  */
-export declare const writable: <R, W>(read: (get: Context) => R, write: (ctx: WriteContext<R>, value: W) => void, refresh?: (f: <A>(atom: Atom<A>) => void) => void) => Writable<R, W>;
+export declare const writable: <R, W>(read: (get: AtomContext) => R, write: (ctx: WriteContext<R>, value: W) => void, refresh?: (f: <A>(atom: Atom<A>) => void) => void) => Writable<R, W>;
 /**
  * @since 4.0.0
  * @category constructors
@@ -175,7 +176,7 @@ export declare const make: {
      * @since 4.0.0
      * @category constructors
      */
-    <A, E>(create: (get: Context) => Effect.Effect<A, E, Scope.Scope | AtomRegistry>, options?: {
+    <A, E>(create: (get: AtomContext) => Effect.Effect<A, E, Scope.Scope | AtomRegistry>, options?: {
         readonly initialValue?: A | undefined;
         readonly uninterruptible?: boolean | undefined;
     }): Atom<AsyncResult.AsyncResult<A, E>>;
@@ -191,21 +192,21 @@ export declare const make: {
      * @since 4.0.0
      * @category constructors
      */
-    <A, E>(create: (get: Context) => Stream.Stream<A, E, AtomRegistry>, options?: {
+    <A, E>(create: (get: AtomContext) => Stream.Stream<A, E, AtomRegistry>, options?: {
         readonly initialValue?: A;
-    }): Atom<AsyncResult.AsyncResult<A, E>>;
+    }): Atom<AsyncResult.AsyncResult<A, E | Cause.NoSuchElementError>>;
     /**
      * @since 4.0.0
      * @category constructors
      */
     <A, E>(stream: Stream.Stream<A, E, AtomRegistry>, options?: {
         readonly initialValue?: A;
-    }): Atom<AsyncResult.AsyncResult<A, E>>;
+    }): Atom<AsyncResult.AsyncResult<A, E | Cause.NoSuchElementError>>;
     /**
      * @since 4.0.0
      * @category constructors
      */
-    <A>(create: (get: Context) => A): Atom<A>;
+    <A>(create: (get: AtomContext) => A): Atom<A>;
     /**
      * @since 4.0.0
      * @category constructors
@@ -216,11 +217,11 @@ export declare const make: {
  * @since 4.0.0
  * @category models
  */
-export interface AtomRuntime<R, ER = never> extends Atom<AsyncResult.AsyncResult<ServiceMap.ServiceMap<R>, ER>> {
+export interface AtomRuntime<R, ER = never> extends Atom<AsyncResult.AsyncResult<Context.Context<R>, ER>> {
     readonly factory: RuntimeFactory;
     readonly layer: Atom<Layer.Layer<R, ER>>;
     readonly atom: {
-        <A, E>(create: (get: Context) => Effect.Effect<A, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity>, options?: {
+        <A, E>(create: (get: AtomContext) => Effect.Effect<A, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity>, options?: {
             readonly initialValue?: A;
             readonly uninterruptible?: boolean | undefined;
         }): Atom<AsyncResult.AsyncResult<A, E | ER>>;
@@ -228,12 +229,12 @@ export interface AtomRuntime<R, ER = never> extends Atom<AsyncResult.AsyncResult
             readonly initialValue?: A;
             readonly uninterruptible?: boolean | undefined;
         }): Atom<AsyncResult.AsyncResult<A, E | ER>>;
-        <A, E>(create: (get: Context) => Stream.Stream<A, E, AtomRegistry | Reactivity.Reactivity | R>, options?: {
+        <A, E>(create: (get: AtomContext) => Stream.Stream<A, E, AtomRegistry | Reactivity.Reactivity | R>, options?: {
             readonly initialValue?: A;
-        }): Atom<AsyncResult.AsyncResult<A, E | ER>>;
+        }): Atom<AsyncResult.AsyncResult<A, E | ER | Cause.NoSuchElementError>>;
         <A, E>(stream: Stream.Stream<A, E, AtomRegistry | Reactivity.Reactivity | R>, options?: {
             readonly initialValue?: A;
-        }): Atom<AsyncResult.AsyncResult<A, E | ER>>;
+        }): Atom<AsyncResult.AsyncResult<A, E | ER | Cause.NoSuchElementError>>;
     };
     readonly fn: {
         <Arg>(): {
@@ -259,18 +260,18 @@ export interface AtomRuntime<R, ER = never> extends Atom<AsyncResult.AsyncResult
             readonly concurrent?: boolean | undefined;
         }): AtomResultFn<Arg, A, E | ER | Cause.NoSuchElementError>;
     };
-    readonly pull: <A, E>(create: ((get: Context) => Stream.Stream<A, E, R | AtomRegistry | Reactivity.Reactivity>) | Stream.Stream<A, E, R | AtomRegistry | Reactivity.Reactivity>, options?: {
+    readonly pull: <A, E>(create: ((get: AtomContext) => Stream.Stream<A, E, R | AtomRegistry | Reactivity.Reactivity>) | Stream.Stream<A, E, R | AtomRegistry | Reactivity.Reactivity>, options?: {
         readonly disableAccumulation?: boolean;
         readonly initialValue?: ReadonlyArray<A>;
     }) => Writable<PullResult<A, E | ER>, void>;
-    readonly subscriptionRef: <A, E>(create: Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity> | ((get: Context) => Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity>)) => Writable<AsyncResult.AsyncResult<A, E>, A>;
+    readonly subscriptionRef: <A, E>(create: Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity> | ((get: AtomContext) => Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | R | AtomRegistry | Reactivity.Reactivity>)) => Writable<AsyncResult.AsyncResult<A, E>, A>;
 }
 /**
  * @since 4.0.0
  * @category models
  */
 export interface RuntimeFactory {
-    <R, E>(create: Layer.Layer<R, E, AtomRegistry | Reactivity.Reactivity> | ((get: Context) => Layer.Layer<R, E, AtomRegistry | Reactivity.Reactivity>)): AtomRuntime<R, E>;
+    <R, E>(create: Layer.Layer<R, E, AtomRegistry | Reactivity.Reactivity> | ((get: AtomContext) => Layer.Layer<R, E, AtomRegistry | Reactivity.Reactivity>)): AtomRuntime<R, E>;
     readonly memoMap: Layer.MemoMap;
     readonly addGlobalLayer: <A, E>(layer: Layer.Layer<A, E, AtomRegistry | Reactivity.Reactivity>) => void;
     /**
@@ -313,12 +314,12 @@ export declare const subscriptionRef: {
      * @since 4.0.0
      * @category constructors
      */
-    <A>(ref: SubscriptionRef.SubscriptionRef<A> | ((get: Context) => SubscriptionRef.SubscriptionRef<A>)): Writable<A>;
+    <A>(ref: SubscriptionRef.SubscriptionRef<A> | ((get: AtomContext) => SubscriptionRef.SubscriptionRef<A>)): Writable<A>;
     /**
      * @since 4.0.0
      * @category constructors
      */
-    <A, E>(effect: Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | AtomRegistry> | ((get: Context) => Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | AtomRegistry>)): Writable<AsyncResult.AsyncResult<A, E>, A>;
+    <A, E>(effect: Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | AtomRegistry> | ((get: AtomContext) => Effect.Effect<SubscriptionRef.SubscriptionRef<A>, E, Scope.Scope | AtomRegistry>)): Writable<AsyncResult.AsyncResult<A, E>, A>;
 };
 /**
  * @since 4.0.0
@@ -462,7 +463,7 @@ export type PullResult<A, E = never> = AsyncResult.AsyncResult<{
  * @since 4.0.0
  * @category constructors
  */
-export declare const pull: <A, E>(create: ((get: Context) => Stream.Stream<A, E, AtomRegistry>) | Stream.Stream<A, E, AtomRegistry>, options?: {
+export declare const pull: <A, E>(create: ((get: AtomContext) => Stream.Stream<A, E, AtomRegistry>) | Stream.Stream<A, E, AtomRegistry>, options?: {
     readonly disableAccumulation?: boolean | undefined;
 }) => Writable<PullResult<A, E>, void>;
 /**
@@ -558,12 +559,16 @@ export declare const transform: {
      * @since 4.0.0
      * @category combinators
      */
-    <R extends Atom<any>, B>(f: (get: Context, atom: R) => B): (self: R) => [R] extends [Writable<infer _, infer RW>] ? Writable<B, RW> : Atom<B>;
+    <R extends Atom<any>, B>(f: (get: AtomContext, atom: R) => B, options?: {
+        readonly initialValueTarget?: Atom<B> | undefined;
+    }): (self: R) => [R] extends [Writable<infer _, infer RW>] ? Writable<B, RW> : Atom<B>;
     /**
      * @since 4.0.0
      * @category combinators
      */
-    <R extends Atom<any>, B>(self: R, f: (get: Context, atom: R) => B): [R] extends [Writable<infer _, infer RW>] ? Writable<B, RW> : Atom<B>;
+    <R extends Atom<any>, B>(self: R, f: (get: AtomContext, atom: R) => B, options?: {
+        readonly initialValueTarget?: Atom<B> | undefined;
+    }): [R] extends [Writable<infer _, infer RW>] ? Writable<B, RW> : Atom<B>;
 };
 /**
  * @since 4.0.0
@@ -606,12 +611,12 @@ export declare const debounce: {
      * @since 4.0.0
      * @category combinators
      */
-    (duration: Duration.DurationInput): <A extends Atom<any>>(self: A) => WithoutSerializable<A>;
+    (duration: Duration.Input): <A extends Atom<any>>(self: A) => WithoutSerializable<A>;
     /**
      * @since 4.0.0
      * @category combinators
      */
-    <A extends Atom<any>>(self: A, duration: Duration.DurationInput): WithoutSerializable<A>;
+    <A extends Atom<any>>(self: A, duration: Duration.Input): WithoutSerializable<A>;
 };
 /**
  * Ensures that the value of the atom is refreshed at most once per specified
@@ -628,7 +633,7 @@ export declare const withRefresh: {
      * @since 4.0.0
      * @category combinators
      */
-    (duration: Duration.DurationInput): <A extends Atom<any>>(self: A) => WithoutSerializable<A>;
+    (duration: Duration.Input): <A extends Atom<any>>(self: A) => WithoutSerializable<A>;
     /**
      * Ensures that the value of the atom is refreshed at most once per specified
      * duration.
@@ -636,7 +641,63 @@ export declare const withRefresh: {
      * @since 4.0.0
      * @category combinators
      */
-    <A extends Atom<any>>(self: A, duration: Duration.DurationInput): WithoutSerializable<A>;
+    <A extends Atom<any>>(self: A, duration: Duration.Input): WithoutSerializable<A>;
+};
+/**
+ * Adds stale-while-revalidate refresh behavior to an async result atom.
+ *
+ * Automatic revalidation during reads is skipped while the current value is
+ * fresh within `staleTime`. Manual `refresh` calls remain forceful and always
+ * forward to the wrapped atom.
+ *
+ * Use `revalidateOnMount` to control whether stale data should trigger a
+ * background refresh on first mount. Use `revalidateOnFocus` to control
+ * focus behavior. `true` respects `staleTime` and `"always"` forces refetch.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const swr: {
+    /**
+     * Adds stale-while-revalidate refresh behavior to an async result atom.
+     *
+     * Automatic revalidation during reads is skipped while the current value is
+     * fresh within `staleTime`. Manual `refresh` calls remain forceful and always
+     * forward to the wrapped atom.
+     *
+     * Use `revalidateOnMount` to control whether stale data should trigger a
+     * background refresh on first mount. Use `revalidateOnFocus` to control
+     * focus behavior. `true` respects `staleTime` and `"always"` forces refetch.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    (options: {
+        readonly staleTime: Duration.Input;
+        readonly revalidateOnMount?: boolean | undefined;
+        readonly revalidateOnFocus?: boolean | "always" | undefined;
+        readonly focusSignal?: Atom<any> | undefined;
+    }): <R extends Atom<AsyncResult.AsyncResult<any, any>>>(self: R) => WithoutSerializable<R>;
+    /**
+     * Adds stale-while-revalidate refresh behavior to an async result atom.
+     *
+     * Automatic revalidation during reads is skipped while the current value is
+     * fresh within `staleTime`. Manual `refresh` calls remain forceful and always
+     * forward to the wrapped atom.
+     *
+     * Use `revalidateOnMount` to control whether stale data should trigger a
+     * background refresh on first mount. Use `revalidateOnFocus` to control
+     * focus behavior. `true` respects `staleTime` and `"always"` forces refetch.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <R extends Atom<AsyncResult.AsyncResult<any, any>>>(self: R, options: {
+        readonly staleTime: Duration.Input;
+        readonly revalidateOnMount?: boolean | undefined;
+        readonly revalidateOnFocus?: boolean | "always" | undefined;
+        readonly focusSignal?: Atom<any> | undefined;
+    }): WithoutSerializable<R>;
 };
 /**
  * @since 4.0.0
@@ -706,7 +767,7 @@ export declare const kvs: <S extends Schema.Codec<any, any>, const Mode extends
  */
 export declare const searchParam: <S extends Schema.Codec<any, string> = never>(name: string, options?: {
     readonly schema?: S | undefined;
-}) => Writable<S extends never ? string : Option.Option<S["Type"]>>;
+}) => Writable<[S] extends [never] ? string : Option.Option<S["Type"]>>;
 /**
  * @since 4.0.0
  * @category Conversions