effect 4.0.0-beta.65 → 4.0.0-beta.67

package/dist/SynchronizedRef.js

@@ -1,4 +1,26 @@
 /**
+ * The `SynchronizedRef` module provides mutable references whose updates are
+ * serialized, including updates that run effects before deciding the next
+ * value. A `SynchronizedRef<A>` behaves like a `Ref<A>` for reading and basic
+ * updates, but uses an internal semaphore so concurrent modifications observe a
+ * consistent current value and apply one at a time.
+ *
+ * **When to use**
+ *
+ * - Coordinating shared state that may be updated by many fibers
+ * - Running effectful state transitions that must not overlap
+ * - Computing both a return value and a new stored value atomically
+ * - Applying partial updates with `Option`, where `None` leaves the value
+ *   unchanged
+ *
+ * **Gotchas**
+ *
+ * - Effectful update functions run while the semaphore is held, so long-running
+ *   effects delay other updates to the same ref
+ * - Failed effectful updates do not replace the stored value
+ * - `getUnsafe` and `makeUnsafe` bypass the `Effect` API and should be reserved
+ *   for low-level or carefully controlled code
+ *
  * @since 2.0.0
  */
 import * as Effect from "./Effect.js";
@@ -19,8 +41,12 @@ const Proto = {
   }
 };
 /**
- * @since 4.0.0
+ * Creates a `SynchronizedRef` synchronously from an initial value.
+ *
+ * This bypasses `Effect` construction; prefer `make` in effectful code.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const makeUnsafe = value => {
   const self = Object.create(Proto);
@@ -29,33 +55,49 @@ export const makeUnsafe = value => {
   return self;
 };
 /**
- * @since 2.0.0
+ * Creates a `SynchronizedRef` from an initial value, wrapped in an `Effect`.
+ *
  * @category constructors
+ * @since 2.0.0
  */
 export const make = value => Effect.sync(() => makeUnsafe(value));
 /**
- * @since 2.0.0
+ * Reads the current value synchronously, bypassing the `Effect` API and the
+ * ref's semaphore.
+ *
  * @category getters
+ * @since 2.0.0
  */
 export const getUnsafe = self => self.backing.ref.current;
 /**
- * @since 2.0.0
+ * Returns an `Effect` that reads the current value of the `SynchronizedRef`.
+ *
  * @category getters
+ * @since 2.0.0
  */
 export const get = self => Effect.sync(() => getUnsafe(self));
 /**
- * @since 2.0.0
+ * Atomically sets a new value and returns the previous value, serialized by the
+ * ref's semaphore.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const getAndSet = /*#__PURE__*/dual(2, (self, value) => self.semaphore.withPermit(Ref.getAndSet(self.backing, value)));
 /**
- * @since 2.0.0
+ * Atomically updates the current value with a function and returns the previous
+ * value, serialized by the ref's semaphore.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Ref.getAndUpdate(self.backing, f)));
 /**
- * @since 2.0.0
+ * Atomically runs an effectful update while holding the ref's semaphore, sets
+ * the new value if the effect succeeds, and returns the previous value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const getAndUpdateEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -65,13 +107,21 @@ export const getAndUpdateEffect = /*#__PURE__*/dual(2, (self, f) => self.semapho
   });
 })));
 /**
- * @since 2.0.0
+ * Atomically applies a partial update and returns the previous value. If the
+ * function returns `Option.some`, the ref is updated; if it returns
+ * `Option.none`, the ref is left unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const getAndUpdateSome = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Ref.getAndUpdateSome(self, pf)));
 /**
- * @since 2.0.0
+ * Atomically runs an effectful partial update while holding the ref's semaphore
+ * and returns the previous value. `Option.some` updates the ref; `Option.none`
+ * leaves it unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const getAndUpdateSomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -84,13 +134,19 @@ export const getAndUpdateSomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.se
   });
 })));
 /**
- * @since 2.0.0
+ * Atomically computes a return value and a new ref value, stores the new value,
+ * and returns the computed result.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const modify = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Ref.modify(self.backing, f)));
 /**
- * @since 2.0.0
+ * Atomically runs an effectful modification while holding the ref's semaphore,
+ * stores the new value if the effect succeeds, and returns the computed result.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const modifyEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -100,13 +156,20 @@ export const modifyEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.wit
   });
 })));
 /**
- * @since 2.0.0
+ * Atomically computes a return value and an optional new ref value.
+ * `Option.some` updates the ref; `Option.none` leaves it unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const modifySome = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Ref.modifySome(self.backing, pf)));
 /**
- * @since 2.0.0
+ * Atomically runs an effectful modification while holding the ref's semaphore.
+ * The effect computes a return value and an optional new ref value;
+ * `Option.some` updates the ref and `Option.none` leaves it unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const modifySomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -119,23 +182,33 @@ export const modifySomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphor
   });
 })));
 /**
- * @since 2.0.0
+ * Sets the value of the `SynchronizedRef`, serialized by the ref's semaphore.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const set = /*#__PURE__*/dual(2, (self, value) => self.semaphore.withPermit(Ref.set(self.backing, value)));
 /**
- * @since 2.0.0
+ * Sets the value of the `SynchronizedRef` and returns the new value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const setAndGet = /*#__PURE__*/dual(2, (self, value) => self.semaphore.withPermit(Ref.setAndGet(self.backing, value)));
 /**
- * @since 2.0.0
+ * Updates the value of the `SynchronizedRef` with a function, serialized by the
+ * ref's semaphore.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const update = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Ref.update(self.backing, f)));
 /**
- * @since 2.0.0
+ * Runs an effectful update while holding the ref's semaphore and stores the new
+ * value if the effect succeeds.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -144,13 +217,19 @@ export const updateEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.wit
   });
 })));
 /**
- * @since 2.0.0
+ * Updates the value of the `SynchronizedRef` with a function and returns the
+ * new value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Ref.updateAndGet(self.backing, f)));
 /**
- * @since 2.0.0
+ * Runs an effectful update while holding the ref's semaphore, stores the new
+ * value if the effect succeeds, and returns that new value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateAndGetEffect = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -160,13 +239,19 @@ export const updateAndGetEffect = /*#__PURE__*/dual(2, (self, f) => self.semapho
   });
 })));
 /**
- * @since 2.0.0
+ * Applies a partial update to the current value. `Option.some` stores the new
+ * value; `Option.none` leaves the ref unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateSome = /*#__PURE__*/dual(2, (self, f) => self.semaphore.withPermit(Ref.updateSome(self.backing, f)));
 /**
- * @since 2.0.0
+ * Runs an effectful partial update while holding the ref's semaphore.
+ * `Option.some` stores the new value; `Option.none` leaves the ref unchanged.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateSomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);
@@ -178,13 +263,21 @@ export const updateSomeEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphor
   });
 })));
 /**
- * @since 2.0.0
+ * Applies a partial update and returns the resulting current value.
+ * `Option.some` stores and returns the new value; `Option.none` returns the
+ * unchanged value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateSomeAndGet = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Ref.updateSomeAndGet(self.backing, pf)));
 /**
- * @since 2.0.0
+ * Runs an effectful partial update while holding the ref's semaphore and
+ * returns the resulting current value. `Option.some` stores and returns the new
+ * value; `Option.none` returns the unchanged value.
+ *
  * @category utils
+ * @since 2.0.0
  */
 export const updateSomeAndGetEffect = /*#__PURE__*/dual(2, (self, pf) => self.semaphore.withPermit(Effect.suspend(() => {
   const value = getUnsafe(self);

package/dist/SynchronizedRef.js.map

@@ -1 +1 @@
-{"version":3,"file":"SynchronizedRef.js","names":["Effect","dual","PipeInspectableProto","Option","Ref","Semaphore","TypeId","Proto","toJSON","_id","value","backing","ref","current","makeUnsafe","self","Object","create","semaphore","make","sync","getUnsafe","get","getAndSet","withPermit","getAndUpdate","f","getAndUpdateEffect","suspend","map","newValue","getAndUpdateSome","pf","getAndUpdateSomeEffect","flatMap","option","isNone","succeed","modify","modifyEffect","b","a","modifySome","modifySomeEffect","maybeA","set","setAndGet","update","updateEffect","updateAndGet","updateAndGetEffect","updateSome","updateSomeEffect","updateSomeAndGet","updateSomeAndGetEffect"],"sources":["../src/SynchronizedRef.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SynchronizedRef.js","names":["Effect","dual","PipeInspectableProto","Option","Ref","Semaphore","TypeId","Proto","toJSON","_id","value","backing","ref","current","makeUnsafe","self","Object","create","semaphore","make","sync","getUnsafe","get","getAndSet","withPermit","getAndUpdate","f","getAndUpdateEffect","suspend","map","newValue","getAndUpdateSome","pf","getAndUpdateSomeEffect","flatMap","option","isNone","succeed","modify","modifyEffect","b","a","modifySome","modifySomeEffect","maybeA","set","setAndGet","update","updateEffect","updateAndGet","updateAndGetEffect","updateSome","updateSomeEffect","updateSomeAndGet","updateSomeAndGetEffect"],"sources":["../src/SynchronizedRef.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/Take.d.ts

@@ -1,17 +1,41 @@
 /**
+ * The `Take` module provides the representation used by stream-like producers
+ * to describe a single pull result. A `Take<A, E, Done>` is either a
+ * non-empty batch of emitted values, a failed `Exit`, or a successful `Exit`
+ * carrying the stream's completion value.
+ *
+ * `Take` is useful at boundaries where pull results need to be stored,
+ * transferred, or interpreted later while preserving the distinction between
+ * emitted elements, failures, and normal completion. Use {@link toPull} to turn
+ * a `Take` back into a `Pull`: value batches become successful pulls, failure
+ * exits are propagated, and successful exits signal completion with `Done`.
+ *
+ * **Gotchas**
+ *
+ * - A value batch is always represented by a `NonEmptyReadonlyArray`; empty
+ *   batches are not valid `Take` values.
+ * - Successful `Exit` values do not emit elements. They represent pull
+ *   completion and carry the `Done` value.
+ *
  * @since 2.0.0
  */
 import type { NonEmptyReadonlyArray } from "./Array.ts";
 import * as Exit from "./Exit.ts";
 import type * as Pull from "./Pull.ts";
 /**
- * @since 2.0.0
+ * Represents one pull result: either a non-empty batch of values, a failure
+ * `Exit`, or a successful `Exit` that signals completion with a `Done` value.
+ *
  * @category Models
+ * @since 2.0.0
  */
 export type Take<A, E = never, Done = void> = NonEmptyReadonlyArray<A> | Exit.Exit<Done, E>;
 /**
- * @since 4.0.0
+ * Converts a `Take` into a `Pull`, succeeding with value batches, failing with
+ * failure exits, and translating successful exits into pull completion.
+ *
  * @category Conversions
+ * @since 4.0.0
  */
 export declare const toPull: <A, E, Done>(take: Take<A, E, Done>) => Pull.Pull<NonEmptyReadonlyArray<A>, E, Done>;
 //# sourceMappingURL=Take.d.ts.map

package/dist/Take.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Take.d.ts","sourceRoot":"","sources":["../src/Take.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGvD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AAEtC;;;GAGG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAE3F;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAG7E,CAAA"}
+{"version":3,"file":"Take.d.ts","sourceRoot":"","sources":["../src/Take.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGvD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAE3F;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAG7E,CAAA"}

package/dist/Take.js

@@ -2,8 +2,11 @@ import * as Cause from "./Cause.js";
 import * as Effect from "./Effect.js";
 import * as Exit from "./Exit.js";
 /**
- * @since 4.0.0
+ * Converts a `Take` into a `Pull`, succeeding with value batches, failing with
+ * failure exits, and translating successful exits into pull completion.
+ *
  * @category Conversions
+ * @since 4.0.0
  */
 export const toPull = take => Exit.isExit(take) ? Exit.isSuccess(take) ? Cause.done(take.value) : take : Effect.succeed(take);
 //# sourceMappingURL=Take.js.map

package/dist/Take.js.map

@@ -1 +1 @@
-{"version":3,"file":"Take.js","names":["Cause","Effect","Exit","toPull","take","isExit","isSuccess","done","value","succeed"],"sources":["../src/Take.ts"],"sourcesContent":[null],"mappings":"AAIA,OAAO,KAAKA,KAAK,MAAM,YAAY;AACnC,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,OAAO,KAAKC,IAAI,MAAM,WAAW;AASjC;;;;AAIA,OAAO,MAAMC,MAAM,GAAgBC,IAAsB,IACvDF,IAAI,CAACG,MAAM,CAACD,IAAI,CAAC,GACbF,IAAI,CAACI,SAAS,CAACF,IAAI,CAAC,GAAGJ,KAAK,CAACO,IAAI,CAACH,IAAI,CAACI,KAAK,CAAC,GAAIJ,IAA4B,GAC7EH,MAAM,CAACQ,OAAO,CAACL,IAAI,CAAC","ignoreList":[]}
+{"version":3,"file":"Take.js","names":["Cause","Effect","Exit","toPull","take","isExit","isSuccess","done","value","succeed"],"sources":["../src/Take.ts"],"sourcesContent":[null],"mappings":"AAsBA,OAAO,KAAKA,KAAK,MAAM,YAAY;AACnC,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,OAAO,KAAKC,IAAI,MAAM,WAAW;AAYjC;;;;;;;AAOA,OAAO,MAAMC,MAAM,GAAgBC,IAAsB,IACvDF,IAAI,CAACG,MAAM,CAACD,IAAI,CAAC,GACbF,IAAI,CAACI,SAAS,CAACF,IAAI,CAAC,GAAGJ,KAAK,CAACO,IAAI,CAACH,IAAI,CAACI,KAAK,CAAC,GAAIJ,IAA4B,GAC7EH,MAAM,CAACQ,OAAO,CAACL,IAAI,CAAC","ignoreList":[]}

package/dist/Terminal.d.ts

@@ -1,4 +1,20 @@
 /**
+ * The `Terminal` module defines the service interface used by platform
+ * integrations to model command-line input and output. It gives programs a
+ * uniform way to query terminal dimensions, read lines, stream low-level key
+ * events, and write text without depending directly on Node, the browser, or a
+ * test-specific console implementation.
+ *
+ * Use this module when building interactive command-line tools, prompts, or
+ * platform abstractions that need terminal capabilities as an Effect service.
+ * Implementations are supplied through context, so application code can depend
+ * on `Terminal` while tests and runtimes provide the concrete behavior.
+ *
+ * `readLine` can fail with {@link QuitError} when the user requests to quit,
+ * commonly via `Ctrl+C`. For lower-level interaction, `readInput` returns a
+ * scoped stream of {@link UserInput} values containing parsed key metadata and
+ * any raw character input.
+ *
  * @since 4.0.0
  */
 import type * as Cause from "./Cause.ts";
@@ -14,8 +30,8 @@ declare const TypeId = "~effect/platform/Terminal";
  * A `Terminal` represents a command-line interface which can read input from a
  * user and display messages to a user.
  *
- * @since 4.0.0
  * @category Models
+ * @since 4.0.0
  */
 export interface Terminal {
     readonly [TypeId]: typeof TypeId;
@@ -23,6 +39,10 @@ export interface Terminal {
      * The number of columns available on the platform's terminal interface.
      */
     readonly columns: Effect.Effect<number>;
+    /**
+     * The number of rows available on the platform's terminal interface.
+     */
+    readonly rows: Effect.Effect<number>;
     /**
      * Reads input events from the default standard input.
      */
@@ -37,8 +57,11 @@ export interface Terminal {
     readonly display: (text: string) => Effect.Effect<void, PlatformError>;
 }
 /**
- * @since 4.0.0
+ * Keyboard key metadata for terminal input, including the key name and
+ * modifier state.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export interface Key {
     /**
@@ -59,8 +82,11 @@ export interface Key {
     readonly shift: boolean;
 }
 /**
- * @since 4.0.0
+ * A terminal input event containing an optional raw character and the parsed
+ * key that was pressed.
+ *
  * @category Models
+ * @since 4.0.0
  */
 export interface UserInput {
     /**
@@ -80,30 +106,36 @@ declare const QuitError_base: Schema.Class<QuitError, Schema.Struct<{
  * A `QuitError` represents an error that occurs when a user attempts to
  * quit out of a `Terminal` prompt for input (usually by entering `ctrl`+`c`).
  *
- * @since 4.0.0
  * @category QuitError
+ * @since 4.0.0
  */
 export declare class QuitError extends QuitError_base {
     /**
+     * Marks this value as a terminal quit error for runtime guards.
+     *
      * @since 4.0.0
      */
     readonly [QuitErrorTypeId] = "effect/platform/Terminal/QuitError";
 }
 /**
- * @since 4.0.0
+ * Returns `true` if the provided value is a `Terminal.QuitError`.
+ *
  * @category QuitError
+ * @since 4.0.0
  */
 export declare const isQuitError: (u: unknown) => u is QuitError;
 /**
- * @since 4.0.0
+ * Context service tag for accessing a `Terminal` implementation.
+ *
  * @category Services
+ * @since 4.0.0
  */
 export declare const Terminal: Context.Service<Terminal, Terminal>;
 /**
  * Creates a Terminal implementation
  *
- * @since 4.0.0
  * @category Constructors
+ * @since 4.0.0
  */
 export declare const make: (impl: Omit<Terminal, typeof TypeId>) => Terminal;
 export {};

package/dist/Terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,QAAA,MAAM,MAAM,8BAA8B,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3F;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;CACvE;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB;AAED,QAAA,MAAM,eAAe,uCAAuC,CAAA;;;;AAE5D;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,cAE7B;IACA;;OAEG;IACH,QAAQ,CAAC,CAAC,eAAe,CAAC,wCAAkB;CAC7C;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,SAAsD,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAA+C,CAAA;AAExG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,MAAM,CAAC,KAClC,QAAsD,CAAA"}
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../src/Terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,QAAA,MAAM,MAAM,8BAA8B,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC;;OAEG;IAEH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3F;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;CACvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAClB;AAED,QAAA,MAAM,eAAe,uCAAuC,CAAA;;;;AAE5D;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,cAE7B;IACA;;;;OAIG;IACH,QAAQ,CAAC,CAAC,eAAe,CAAC,wCAAkB;CAC7C;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,SAAsD,CAAA;AAEpG;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAA+C,CAAA;AAExG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,MAAM,CAAC,KAClC,QAAsD,CAAA"}

package/dist/Terminal.js

@@ -7,32 +7,38 @@ const QuitErrorTypeId = "effect/platform/Terminal/QuitError";
  * A `QuitError` represents an error that occurs when a user attempts to
  * quit out of a `Terminal` prompt for input (usually by entering `ctrl`+`c`).
  *
- * @since 4.0.0
  * @category QuitError
+ * @since 4.0.0
  */
 export class QuitError extends /*#__PURE__*/Schema.ErrorClass("QuitError")({
   _tag: /*#__PURE__*/Schema.tag("QuitError")
 }) {
   /**
+   * Marks this value as a terminal quit error for runtime guards.
+   *
    * @since 4.0.0
    */
   [QuitErrorTypeId] = QuitErrorTypeId;
 }
 /**
- * @since 4.0.0
+ * Returns `true` if the provided value is a `Terminal.QuitError`.
+ *
  * @category QuitError
+ * @since 4.0.0
  */
 export const isQuitError = u => Predicate.hasProperty(u, QuitErrorTypeId);
 /**
- * @since 4.0.0
+ * Context service tag for accessing a `Terminal` implementation.
+ *
  * @category Services
+ * @since 4.0.0
  */
 export const Terminal = /*#__PURE__*/Context.Service("effect/platform/Terminal");
 /**
  * Creates a Terminal implementation
  *
- * @since 4.0.0
  * @category Constructors
+ * @since 4.0.0
  */
 export const make = impl => Terminal.of({
   ...impl,

package/dist/Terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Terminal.js","names":["Context","Predicate","Schema","TypeId","QuitErrorTypeId","QuitError","ErrorClass","_tag","tag","isQuitError","u","hasProperty","Terminal","Service","make","impl","of"],"sources":["../src/Terminal.ts"],"sourcesContent":[null],"mappings":"AAIA,OAAO,KAAKA,OAAO,MAAM,cAAc;AAIvC,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAGrC,MAAMC,MAAM,GAAG,2BAA2B;AAoE1C,MAAMC,eAAe,GAAG,oCAAoC;AAE5D;;;;;;;AAOA,OAAM,MAAOC,SAAU,sBAAQH,MAAM,CAACI,UAAU,CAAY,WAAW,CAAC,CAAC;EACvEC,IAAI,eAAEL,MAAM,CAACM,GAAG,CAAC,WAAW;CAC7B,CAAC;EACA;;;EAGS,CAACJ,eAAe,IAAIA,eAAe;;AAG9C;;;;AAIA,OAAO,MAAMK,WAAW,GAAIC,CAAU,IAAqBT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,eAAe,CAAC;AAEpG;;;;AAIA,OAAO,MAAMQ,QAAQ,gBAAwCZ,OAAO,CAACa,OAAO,CAAC,0BAA0B,CAAC;AAExG;;;;;;AAMA,OAAO,MAAMC,IAAI,GACfC,IAAmC,IACtBH,QAAQ,CAACI,EAAE,CAAC;EAAE,GAAGD,IAAI;EAAE,CAACZ,MAAM,GAAGA;AAAM,CAAE,CAAC","ignoreList":[]}
+{"version":3,"file":"Terminal.js","names":["Context","Predicate","Schema","TypeId","QuitErrorTypeId","QuitError","ErrorClass","_tag","tag","isQuitError","u","hasProperty","Terminal","Service","make","impl","of"],"sources":["../src/Terminal.ts"],"sourcesContent":[null],"mappings":"AAoBA,OAAO,KAAKA,OAAO,MAAM,cAAc;AAIvC,OAAO,KAAKC,SAAS,MAAM,gBAAgB;AAE3C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAGrC,MAAMC,MAAM,GAAG,2BAA2B;AA+E1C,MAAMC,eAAe,GAAG,oCAAoC;AAE5D;;;;;;;AAOA,OAAM,MAAOC,SAAU,sBAAQH,MAAM,CAACI,UAAU,CAAY,WAAW,CAAC,CAAC;EACvEC,IAAI,eAAEL,MAAM,CAACM,GAAG,CAAC,WAAW;CAC7B,CAAC;EACA;;;;;EAKS,CAACJ,eAAe,IAAIA,eAAe;;AAG9C;;;;;;AAMA,OAAO,MAAMK,WAAW,GAAIC,CAAU,IAAqBT,SAAS,CAACU,WAAW,CAACD,CAAC,EAAEN,eAAe,CAAC;AAEpG;;;;;;AAMA,OAAO,MAAMQ,QAAQ,gBAAwCZ,OAAO,CAACa,OAAO,CAAC,0BAA0B,CAAC;AAExG;;;;;;AAMA,OAAO,MAAMC,IAAI,GACfC,IAAmC,IACtBH,QAAQ,CAACI,EAAE,CAAC;EAAE,GAAGD,IAAI;EAAE,CAACZ,MAAM,GAAGA;AAAM,CAAE,CAAC","ignoreList":[]}