effect 3.13.7 → 3.13.9

package/src/Option.ts

@@ -1161,6 +1161,7 @@ export const liftThrowable = <A extends ReadonlyArray<unknown>, B>(
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Option } from "effect"
  *
  * assert.deepStrictEqual(
@@ -1190,6 +1191,7 @@ export const getOrThrowWith: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option } from "effect"
    *
    * assert.deepStrictEqual(
@@ -1219,6 +1221,7 @@ export const getOrThrowWith: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option } from "effect"
    *
    * assert.deepStrictEqual(
@@ -1254,6 +1257,7 @@ export const getOrThrowWith: {
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Option } from "effect"
  *
  * assert.deepStrictEqual(Option.getOrThrow(Option.some(1)), 1)
@@ -3675,6 +3679,7 @@ export const exists: {
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Option, pipe } from "effect"
  *
  * const result = pipe(
@@ -3712,6 +3717,7 @@ export const bindTo: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option, pipe } from "effect"
    *
    * const result = pipe(
@@ -3749,6 +3755,7 @@ export const bindTo: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option, pipe } from "effect"
    *
    * const result = pipe(
@@ -3797,6 +3804,7 @@ export {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option, pipe } from "effect"
    *
    * const result = pipe(
@@ -3832,6 +3840,7 @@ export {
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Option, pipe } from "effect"
  *
  * const result = pipe(
@@ -3865,6 +3874,7 @@ export const bind: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option, pipe } from "effect"
    *
    * const result = pipe(
@@ -3898,6 +3908,7 @@ export const bind: {
    *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Option, pipe } from "effect"
    *
    * const result = pipe(
@@ -3937,6 +3948,7 @@ export const bind: {
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Option, pipe } from "effect"
  *
  * const result = pipe(

package/src/Order.ts

@@ -343,6 +343,7 @@ export const max = <A>(O: Order<A>): {
  *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Order, Number } from "effect"
  *
  * const clamp = Order.clamp(Number.Order)({ minimum: 1, maximum: 5 })

package/src/Ordering.ts

@@ -13,10 +13,9 @@ export type Ordering = -1 | 0 | 1
 /**
  * Inverts the ordering of the input `Ordering`.
  *
- * @param o - The input `Ordering`.
- *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { reverse } from "effect/Ordering"
  *
  * assert.deepStrictEqual(reverse(1), -1)
@@ -31,13 +30,9 @@ export const reverse = (o: Ordering): Ordering => (o === -1 ? 1 : o === 1 ? -1 :
 /**
  * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
  *
- * @param self - The `Ordering` parameter to match against.
- * @param onLessThan - A function that will be called if the `Ordering` parameter is `-1`.
- * @param onEqual - A function that will be called if the `Ordering` parameter is `0`.
- * @param onGreaterThan - A function that will be called if the `Ordering` parameter is `1`.
- *
  * @example
  * ```ts
+ * import * as assert from "node:assert"
  * import { Ordering } from "effect"
  * import { constant } from "effect/Function"
  *
@@ -59,13 +54,9 @@ export const match: {
   /**
    * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
    *
-   * @param self - The `Ordering` parameter to match against.
-   * @param onLessThan - A function that will be called if the `Ordering` parameter is `-1`.
-   * @param onEqual - A function that will be called if the `Ordering` parameter is `0`.
-   * @param onGreaterThan - A function that will be called if the `Ordering` parameter is `1`.
-   *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Ordering } from "effect"
    * import { constant } from "effect/Function"
    *
@@ -93,13 +84,9 @@ export const match: {
   /**
    * Depending on the `Ordering` parameter given to it, returns a value produced by one of the 3 functions provided as parameters.
    *
-   * @param self - The `Ordering` parameter to match against.
-   * @param onLessThan - A function that will be called if the `Ordering` parameter is `-1`.
-   * @param onEqual - A function that will be called if the `Ordering` parameter is `0`.
-   * @param onGreaterThan - A function that will be called if the `Ordering` parameter is `1`.
-   *
    * @example
    * ```ts
+   * import * as assert from "node:assert"
    * import { Ordering } from "effect"
    * import { constant } from "effect/Function"
    *

package/src/ParseResult.ts

@@ -2015,7 +2015,7 @@ const makeArrayFormatterIssue = (
  * @since 3.10.0
  */
 export const ArrayFormatter: ParseResultFormatter<Array<ArrayFormatterIssue>> = {
-  formatIssue: (issue) => getArrayFormatterIssues(issue),
+  formatIssue: (issue) => getArrayFormatterIssues(issue, undefined, []),
   formatIssueSync: (issue) => {
     const e = ArrayFormatter.formatIssue(issue)
     return isEither(e) ? Either.getOrThrow(e) : Effect.runSync(e)
@@ -2026,12 +2026,13 @@ export const ArrayFormatter: ParseResultFormatter<Array<ArrayFormatterIssue>> =
 
 const getArrayFormatterIssues = (
   issue: ParseIssue,
-  path: ReadonlyArray<PropertyKey> = []
+  parentTag: ArrayFormatterIssue["_tag"] | undefined,
+  path: ReadonlyArray<PropertyKey>
 ): Effect.Effect<Array<ArrayFormatterIssue>> => {
   const _tag = issue._tag
   switch (_tag) {
     case "Type":
-      return map(formatTypeMessage(issue), (message) => [makeArrayFormatterIssue(_tag, path, message)])
+      return map(formatTypeMessage(issue), (message) => [makeArrayFormatterIssue(parentTag ?? _tag, path, message)])
     case "Forbidden":
       return Either.right([makeArrayFormatterIssue(_tag, path, formatForbiddenMessage(issue))])
     case "Unexpected":
@@ -2039,23 +2040,29 @@ const getArrayFormatterIssues = (
     case "Missing":
       return map(formatMissingMessage(issue), (message) => [makeArrayFormatterIssue(_tag, path, message)])
     case "Pointer":
-      return getArrayFormatterIssues(issue.issue, path.concat(issue.path))
+      return getArrayFormatterIssues(issue.issue, undefined, path.concat(issue.path))
     case "Composite":
       return flatMap(getMessage(issue), (message) => {
         if (message !== undefined) {
-          return Either.right([makeArrayFormatterIssue(issue._tag, path, message)])
+          return Either.right([makeArrayFormatterIssue(_tag, path, message)])
         }
         return util_.isNonEmpty(issue.issues)
-          ? map(Effect.forEach(issue.issues, (issue) => getArrayFormatterIssues(issue, path)), Arr.flatten)
-          : getArrayFormatterIssues(issue.issues, path)
+          ? map(Effect.forEach(issue.issues, (issue) => getArrayFormatterIssues(issue, undefined, path)), Arr.flatten)
+          : getArrayFormatterIssues(issue.issues, undefined, path)
       })
     case "Refinement":
+      return flatMap(getMessage(issue), (message) => {
+        if (message !== undefined) {
+          return Either.right([makeArrayFormatterIssue(_tag, path, message)])
+        }
+        return getArrayFormatterIssues(issue.issue, issue.kind === "Predicate" ? _tag : undefined, path)
+      })
     case "Transformation":
       return flatMap(getMessage(issue), (message) => {
         if (message !== undefined) {
-          return Either.right([makeArrayFormatterIssue(issue._tag, path, message)])
+          return Either.right([makeArrayFormatterIssue(_tag, path, message)])
         }
-        return getArrayFormatterIssues(issue.issue, path)
+        return getArrayFormatterIssues(issue.issue, issue.kind === "Transformation" ? _tag : undefined, path)
       })
   }
 }

package/src/Pool.ts

@@ -145,7 +145,7 @@ export const make: <A, E, R>(
  *
  * By default, the `timeToLiveStrategy` is set to "usage".
  *
- * ```ts
+ * ```ts skip-type-checking
  * import { createConnection } from "mysql2";
  * import { Duration, Effect, Pool } from "effect"
  *