effect 3.12.4 → 3.12.5

package/dist/cjs/Schema.js

@@ -3,15 +3,15 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ListFromSelf = exports.List = exports.LessThanSchemaId = exports.LessThanOrEqualToSchemaId = exports.LessThanOrEqualToDurationSchemaId = exports.LessThanOrEqualToDateSchemaId = exports.LessThanOrEqualToBigIntSchemaId = exports.LessThanOrEqualToBigDecimalSchemaId = exports.LessThanDurationSchemaId = exports.LessThanDateSchemaId = exports.LessThanBigIntSchemaId = exports.LessThanBigDecimalSchemaId = exports.LengthSchemaId = exports.JsonNumberSchemaId = exports.JsonNumber = exports.ItemsCountSchemaId = exports.IntSchemaId = exports.Int = exports.InstanceOfSchemaId = exports.IncludesSchemaId = exports.HashSetFromSelf = exports.HashSet = exports.HashMapFromSelf = exports.HashMap = exports.GreaterThanSchemaId = exports.GreaterThanOrEqualToSchemaId = exports.GreaterThanOrEqualToDurationSchemaId = exports.GreaterThanOrEqualToDateSchemaId = exports.GreaterThanOrEqualToBigIntSchemaId = exports.GreaterThanOrEqualToBigDecimalSchemaId = exports.GreaterThanDurationSchemaId = exports.GreaterThanDateSchemaId = exports.GreaterThanBigIntSchemaId = exports.GreaterThanBigDecimalSchemaId = exports.FromPropertySignature = exports.FiniteSchemaId = exports.Finite = exports.FiberIdFromSelf = exports.FiberId = exports.ExitFromSelf = exports.Exit = exports.Enums = exports.EndsWithSchemaId = exports.EitherFromUnion = exports.EitherFromSelf = exports.Either = exports.DurationFromSelf = exports.DurationFromNanos = exports.DurationFromMillis = exports.Duration = exports.Defect = exports.DateTimeZonedFromSelf = exports.DateTimeZoned = exports.DateTimeUtcFromSelf = exports.DateTimeUtcFromNumber = exports.DateTimeUtcFromDate = exports.DateTimeUtc = exports.DateFromString = exports.DateFromSelfSchemaId = exports.DateFromSelf = exports.DateFromNumber = exports.Date = exports.DataFromSelf = exports.Data = exports.Config = exports.Class = exports.ChunkFromSelf = exports.Chunk = exports.Char = exports.CauseFromSelf = exports.Cause = exports.CapitalizedSchemaId = exports.Capitalized = exports.Capitalize = exports.BrandSchemaId = exports.BooleanFromUnknown = exports.BooleanFromString = exports.Boolean = exports.BigIntFromSelf = exports.BigIntFromNumber = exports.BigInt = exports.BigDecimalFromSelf = exports.BigDecimalFromNumber = exports.BigDecimal = exports.BetweenSchemaId = exports.BetweenDurationSchemaId = exports.BetweenDateSchemaId = exports.BetweenBigIntSchemaId = exports.BetweenBigDecimalSchemaId = exports.ArrayEnsure = exports.Array = exports.Any = void 0;
+exports.ListFromSelf = exports.List = exports.LessThanSchemaId = exports.LessThanOrEqualToSchemaId = exports.LessThanOrEqualToDurationSchemaId = exports.LessThanOrEqualToDateSchemaId = exports.LessThanOrEqualToBigIntSchemaId = exports.LessThanOrEqualToBigDecimalSchemaId = exports.LessThanDurationSchemaId = exports.LessThanDateSchemaId = exports.LessThanBigIntSchemaId = exports.LessThanBigDecimalSchemaId = exports.LengthSchemaId = exports.JsonNumberSchemaId = exports.JsonNumber = exports.ItemsCountSchemaId = exports.IntSchemaId = exports.Int = exports.InstanceOfSchemaId = exports.IncludesSchemaId = exports.HashSetFromSelf = exports.HashSet = exports.HashMapFromSelf = exports.HashMap = exports.GreaterThanSchemaId = exports.GreaterThanOrEqualToSchemaId = exports.GreaterThanOrEqualToDurationSchemaId = exports.GreaterThanOrEqualToDateSchemaId = exports.GreaterThanOrEqualToBigIntSchemaId = exports.GreaterThanOrEqualToBigDecimalSchemaId = exports.GreaterThanDurationSchemaId = exports.GreaterThanDateSchemaId = exports.GreaterThanBigIntSchemaId = exports.GreaterThanBigDecimalSchemaId = exports.FromPropertySignature = exports.FiniteSchemaId = exports.Finite = exports.FiberIdFromSelf = exports.FiberId = exports.ExitFromSelf = exports.Exit = exports.Enums = exports.EndsWithSchemaId = exports.EitherFromUnion = exports.EitherFromSelf = exports.Either = exports.DurationFromSelf = exports.DurationFromNanos = exports.DurationFromMillis = exports.Duration = exports.Defect = exports.DateTimeZonedFromSelf = exports.DateTimeZoned = exports.DateTimeUtcFromSelf = exports.DateTimeUtcFromNumber = exports.DateTimeUtcFromDate = exports.DateTimeUtc = exports.DateFromString = exports.DateFromSelfSchemaId = exports.DateFromSelf = exports.DateFromNumber = exports.Date = exports.DataFromSelf = exports.Data = exports.Config = exports.Class = exports.ChunkFromSelf = exports.Chunk = exports.Char = exports.CauseFromSelf = exports.Cause = exports.CapitalizedSchemaId = exports.Capitalized = exports.Capitalize = exports.BrandSchemaId = exports.BooleanFromUnknown = exports.BooleanFromString = exports.Boolean = exports.BigIntFromSelf = exports.BigIntFromNumber = exports.BigInt = exports.BigDecimalFromSelf = exports.BigDecimalFromNumber = exports.BigDecimal = exports.BetweenSchemaId = exports.BetweenDurationSchemaId = exports.BetweenDateSchemaId = exports.BetweenBigIntSchemaId = exports.BetweenBigDecimalSchemaId = exports.ArrayFormatterIssue = exports.ArrayEnsure = exports.Array = exports.Any = void 0;
 exports.Literal = Literal;
-exports.MaxItemsSchemaId = exports.MapFromSelf = exports.MapFromRecord = exports.Map = exports.LowercasedSchemaId = exports.Lowercased = exports.Lowercase = void 0;
-exports.StringFromUriComponent = exports.StringFromHex = exports.StringFromBase64Url = exports.StringFromBase64 = exports.String = exports.StartsWithSchemaId = exports.SortedSetFromSelf = exports.SortedSet = exports.SetFromSelf = exports.Set = exports.RefineSchemaId = exports.RedactedFromSelf = exports.Redacted = exports.Record = exports.ReadonlySetFromSelf = exports.ReadonlySet = exports.ReadonlyMapFromSelf = exports.ReadonlyMapFromRecord = exports.ReadonlyMap = exports.PropertySignatureTypeId = exports.PropertySignatureTransformation = exports.PropertySignatureDeclaration = exports.PositiveBigIntFromSelf = exports.PositiveBigInt = exports.PositiveBigDecimalSchemaId = exports.PositiveBigDecimalFromSelf = exports.Positive = exports.PatternSchemaId = exports.OptionFromUndefinedOr = exports.OptionFromSelf = exports.OptionFromNullishOr = exports.OptionFromNullOr = exports.OptionFromNonEmptyTrimmedString = exports.Option = exports.Object = exports.NumberFromString = exports.Number = exports.NullishOr = exports.NullOr = exports.Null = exports.Not = exports.NonPositiveBigIntFromSelf = exports.NonPositiveBigInt = exports.NonPositiveBigDecimalSchemaId = exports.NonPositiveBigDecimalFromSelf = exports.NonPositive = exports.NonNegativeInt = exports.NonNegativeBigIntFromSelf = exports.NonNegativeBigInt = exports.NonNegativeBigDecimalSchemaId = exports.NonNegativeBigDecimalFromSelf = exports.NonNegative = exports.NonNaNSchemaId = exports.NonNaN = exports.NonEmptyTrimmedString = exports.NonEmptyString = exports.NonEmptyChunkFromSelf = exports.NonEmptyChunk = exports.NonEmptyArrayEnsure = exports.NonEmptyArray = exports.Never = exports.NegativeBigIntFromSelf = exports.NegativeBigInt = exports.NegativeBigDecimalSchemaId = exports.NegativeBigDecimalFromSelf = exports.Negative = exports.MultipleOfSchemaId = exports.MinLengthSchemaId = exports.MinItemsSchemaId = exports.MaxLengthSchemaId = void 0;
+exports.MapFromSelf = exports.MapFromRecord = exports.Map = exports.LowercasedSchemaId = exports.Lowercased = exports.Lowercase = void 0;
+exports.StringFromUriComponent = exports.StringFromHex = exports.StringFromBase64Url = exports.StringFromBase64 = exports.String = exports.StartsWithSchemaId = exports.SortedSetFromSelf = exports.SortedSet = exports.SetFromSelf = exports.Set = exports.RefineSchemaId = exports.RedactedFromSelf = exports.Redacted = exports.Record = exports.ReadonlySetFromSelf = exports.ReadonlySet = exports.ReadonlyMapFromSelf = exports.ReadonlyMapFromRecord = exports.ReadonlyMap = exports.PropertySignatureTypeId = exports.PropertySignatureTransformation = exports.PropertySignatureDeclaration = exports.PropertyKey = exports.PositiveBigIntFromSelf = exports.PositiveBigInt = exports.PositiveBigDecimalSchemaId = exports.PositiveBigDecimalFromSelf = exports.Positive = exports.PatternSchemaId = exports.OptionFromUndefinedOr = exports.OptionFromSelf = exports.OptionFromNullishOr = exports.OptionFromNullOr = exports.OptionFromNonEmptyTrimmedString = exports.Option = exports.Object = exports.NumberFromString = exports.Number = exports.NullishOr = exports.NullOr = exports.Null = exports.Not = exports.NonPositiveBigIntFromSelf = exports.NonPositiveBigInt = exports.NonPositiveBigDecimalSchemaId = exports.NonPositiveBigDecimalFromSelf = exports.NonPositive = exports.NonNegativeInt = exports.NonNegativeBigIntFromSelf = exports.NonNegativeBigInt = exports.NonNegativeBigDecimalSchemaId = exports.NonNegativeBigDecimalFromSelf = exports.NonNegative = exports.NonNaNSchemaId = exports.NonNaN = exports.NonEmptyTrimmedString = exports.NonEmptyString = exports.NonEmptyChunkFromSelf = exports.NonEmptyChunk = exports.NonEmptyArrayEnsure = exports.NonEmptyArray = exports.Never = exports.NegativeBigIntFromSelf = exports.NegativeBigInt = exports.NegativeBigDecimalSchemaId = exports.NegativeBigDecimalFromSelf = exports.Negative = exports.MultipleOfSchemaId = exports.MinLengthSchemaId = exports.MinItemsSchemaId = exports.MaxLengthSchemaId = exports.MaxItemsSchemaId = void 0;
 exports.Struct = Struct;
 exports.TrimmedSchemaId = exports.Trimmed = exports.Trim = exports.ToPropertySignature = exports.TimeZoneOffsetFromSelf = exports.TimeZoneOffset = exports.TimeZoneNamedFromSelf = exports.TimeZoneNamed = exports.TimeZoneFromSelf = exports.TimeZone = exports.TemplateLiteralParser = exports.TemplateLiteral = exports.TaggedStruct = exports.TaggedRequest = exports.TaggedError = exports.TaggedClass = exports.SymbolFromSelf = exports.Symbol = void 0;
 exports.Tuple = Tuple;
-exports.Uint8ArrayFromBase64 = exports.Uint8Array = exports.Uint8 = exports.UUIDSchemaId = exports.UUID = exports.URLFromSelf = exports.URL = exports.ULIDSchemaId = exports.ULID = exports.TypeId = void 0;
-exports.UndefinedOr = exports.Undefined = exports.UncapitalizedSchemaId = exports.Uncapitalized = exports.Uncapitalize = exports.Uint8ArrayFromSelf = exports.Uint8ArrayFromHex = exports.Uint8ArrayFromBase64Url = void 0;
+exports.Uint8 = exports.UUIDSchemaId = exports.UUID = exports.URLFromSelf = exports.URL = exports.ULIDSchemaId = exports.ULID = exports.TypeId = void 0;
+exports.UndefinedOr = exports.Undefined = exports.UncapitalizedSchemaId = exports.Uncapitalized = exports.Uncapitalize = exports.Uint8ArrayFromSelf = exports.Uint8ArrayFromHex = exports.Uint8ArrayFromBase64Url = exports.Uint8ArrayFromBase64 = exports.Uint8Array = void 0;
 exports.Union = Union;
 exports.asWithResult = exports.asSerializableWithResult = exports.asSerializable = exports.asSchema = exports.annotations = exports.Void = exports.ValidDateSchemaId = exports.ValidDateFromSelf = exports.UppercasedSchemaId = exports.Uppercased = exports.Uppercase = exports.Unknown = exports.UniqueSymbolFromSelf = void 0;
 Object.defineProperty(exports, "asserts", {
@@ -85,8 +85,8 @@ Object.defineProperty(exports, "is", {
     return ParseResult.is;
   }
 });
-exports.lessThan = exports.length = exports.keyof = exports.itemsCount = exports.isSchema = exports.isPropertySignature = void 0;
-exports.transformLiteral = exports.transform = exports.tag = exports.symbolWithResult = exports.symbolSerializable = exports.suspend = exports.successSchema = exports.startsWith = exports.split = exports.serializeSuccess = exports.serializeFailure = exports.serializeExit = exports.serialize = exports.serializableSchema = exports.requiredToOptional = exports.required = exports.rename = exports.propertySignature = exports.positiveBigInt = exports.positiveBigDecimal = exports.positive = exports.pluck = exports.pickLiteral = exports.pick = exports.pattern = exports.partialWith = exports.partial = exports.parseNumber = exports.parseJson = exports.optionalWith = exports.optionalToRequired = exports.optionalToOptional = exports.optionalElement = exports.optional = exports.omit = exports.nonPositiveBigInt = exports.nonPositiveBigDecimal = exports.nonPositive = exports.nonNegativeBigInt = exports.nonNegativeBigDecimal = exports.nonNegative = exports.nonNaN = exports.nonEmptyString = exports.negativeBigInt = exports.negativeBigDecimal = exports.negative = exports.mutable = exports.multipleOf = exports.minLength = exports.minItems = exports.maxLength = exports.maxItems = exports.makePropertySignature = exports.make = exports.lowercased = exports.lessThanOrEqualToDuration = exports.lessThanOrEqualToDate = exports.lessThanOrEqualToBigInt = exports.lessThanOrEqualToBigDecimal = exports.lessThanOrEqualTo = exports.lessThanDuration = exports.lessThanDate = exports.lessThanBigInt = exports.lessThanBigDecimal = void 0;
+exports.keyof = exports.itemsCount = exports.isSchema = exports.isPropertySignature = void 0;
+exports.transformLiteral = exports.transform = exports.tag = exports.symbolWithResult = exports.symbolSerializable = exports.suspend = exports.successSchema = exports.startsWith = exports.split = exports.serializeSuccess = exports.serializeFailure = exports.serializeExit = exports.serialize = exports.serializableSchema = exports.requiredToOptional = exports.required = exports.rename = exports.propertySignature = exports.positiveBigInt = exports.positiveBigDecimal = exports.positive = exports.pluck = exports.pickLiteral = exports.pick = exports.pattern = exports.partialWith = exports.partial = exports.parseNumber = exports.parseJson = exports.optionalWith = exports.optionalToRequired = exports.optionalToOptional = exports.optionalElement = exports.optional = exports.omit = exports.nonPositiveBigInt = exports.nonPositiveBigDecimal = exports.nonPositive = exports.nonNegativeBigInt = exports.nonNegativeBigDecimal = exports.nonNegative = exports.nonNaN = exports.nonEmptyString = exports.negativeBigInt = exports.negativeBigDecimal = exports.negative = exports.mutable = exports.multipleOf = exports.minLength = exports.minItems = exports.maxLength = exports.maxItems = exports.makePropertySignature = exports.make = exports.lowercased = exports.lessThanOrEqualToDuration = exports.lessThanOrEqualToDate = exports.lessThanOrEqualToBigInt = exports.lessThanOrEqualToBigDecimal = exports.lessThanOrEqualTo = exports.lessThanDuration = exports.lessThanDate = exports.lessThanBigInt = exports.lessThanBigDecimal = exports.lessThan = exports.length = void 0;
 exports.transformLiterals = transformLiterals;
 exports.validateEither = exports.validate = exports.validDate = exports.uppercased = exports.uncapitalized = exports.typeSchema = exports.trimmed = exports.transformOrFail = void 0;
 Object.defineProperty(exports, "validateOption", {
@@ -2283,22 +2283,21 @@ const split = separator => transform(String$.annotations({
   encode: array_.join(separator)
 });
 exports.split = split;
-const JsonString = /*#__PURE__*/String$.annotations({
-  [AST.IdentifierAnnotationId]: "JsonString",
-  [AST.TitleAnnotationId]: "JsonString",
-  [AST.DescriptionAnnotationId]: "a string that will be parsed as JSON"
-});
-const getParseJsonTransformation = options => transformOrFail(JsonString, Unknown, {
+const getErrorMessage = e => e instanceof Error ? e.message : String(e);
+const getParseJsonTransformation = options => transformOrFail(String$.annotations({
+  [AST.DescriptionAnnotationId]: "a string to be decoded into JSON"
+}), Unknown, {
   strict: true,
   decode: (s, _, ast) => ParseResult.try({
     try: () => JSON.parse(s, options?.reviver),
-    catch: e => new ParseResult.Type(ast, s, e.message)
+    catch: e => new ParseResult.Type(ast, s, getErrorMessage(e))
   }),
   encode: (u, _, ast) => ParseResult.try({
     try: () => JSON.stringify(u, options?.replacer, options?.space),
-    catch: e => new ParseResult.Type(ast, u, e.message)
+    catch: e => new ParseResult.Type(ast, u, getErrorMessage(e))
   })
 }).annotations({
+  title: "parseJson",
   schemaId: AST.ParseJsonSchemaId
 });
 /**
@@ -2391,12 +2390,12 @@ class URLFromSelf extends /*#__PURE__*/instanceOf(URL, {
 /** @ignore */
 exports.URLFromSelf = URLFromSelf;
 class URL$ extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a URL"
+  description: "a string to be decoded into a URL"
 }), URLFromSelf, {
   strict: true,
-  decode: (str, _, ast) => ParseResult.try({
-    try: () => new URL(str),
-    catch: () => new ParseResult.Type(ast, str)
+  decode: (s, _, ast) => ParseResult.try({
+    try: () => new URL(s),
+    catch: e => new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a URL. ${getErrorMessage(e)}`)
   }),
   encode: url => ParseResult.succeed(url.toString())
 }).annotations({
@@ -2653,7 +2652,7 @@ const clamp = (minimum, maximum) => self => transform(self, self.pipe(typeSchema
 exports.clamp = clamp;
 const parseNumber = self => transformOrFail(self, Number$, {
   strict: false,
-  decode: (s, _, ast) => ParseResult.fromOption(number_.parse(s), () => new ParseResult.Type(ast, s)),
+  decode: (s, _, ast) => ParseResult.fromOption(number_.parse(s), () => new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a number`)),
   encode: n => ParseResult.succeed(String(n))
 });
 /**
@@ -2668,7 +2667,7 @@ const parseNumber = self => transformOrFail(self, Number$, {
  */
 exports.parseNumber = parseNumber;
 class NumberFromString extends /*#__PURE__*/parseNumber(String$.annotations({
-  description: "a string that will be parsed into a number"
+  description: "a string to be decoded into a number"
 })).annotations({
   identifier: "NumberFromString"
 }) {}
@@ -2770,18 +2769,37 @@ class Not extends /*#__PURE__*/transform( /*#__PURE__*/Boolean$.annotations({
   decode: boolean_.not,
   encode: boolean_.not
 }) {}
-/** @ignore */
 exports.Not = Not;
-class Symbol$ extends /*#__PURE__*/transform(String$.annotations({
-  description: "a string that will be converted to a symbol"
+const encodeSymbol = (sym, _, ast) => {
+  const key = Symbol.keyFor(sym);
+  return key === undefined ? ParseResult.fail(new ParseResult.Type(ast, sym, `Unable to encode a unique symbol ${String(sym)} into a string`)) : ParseResult.succeed(key);
+};
+const decodeSymbol = s => ParseResult.succeed(Symbol.for(s));
+/** @ignore */
+class Symbol$ extends /*#__PURE__*/transformOrFail(String$.annotations({
+  description: "a string to be decoded into a globally shared symbol"
 }), SymbolFromSelf, {
   strict: false,
-  decode: s => Symbol.for(s),
-  encode: sym => sym.description
+  decode: decodeSymbol,
+  encode: encodeSymbol
 }).annotations({
-  identifier: "symbol"
+  identifier: "Symbol"
 }) {}
 exports.Symbol = Symbol$;
+const SymbolStruct = /*#__PURE__*/TaggedStruct("symbol", {
+  key: String$
+}).annotations({
+  description: "an object to be decoded into a globally shared symbol"
+});
+const SymbolFromStruct = /*#__PURE__*/transformOrFail(SymbolStruct, SymbolFromSelf, {
+  strict: true,
+  decode: ({
+    key
+  }) => decodeSymbol(key),
+  encode: (sym, _, ast) => ParseResult.map(encodeSymbol(sym, _, ast), key => SymbolStruct.make({
+    key
+  }))
+});
 /**
  * @category schema id
  * @since 3.10.0
@@ -2931,13 +2949,13 @@ const clampBigInt = (minimum, maximum) => self => transform(self, self.pipe(type
 /** @ignore */
 exports.clampBigInt = clampBigInt;
 class BigInt$ extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a bigint"
+  description: "a string to be decoded into a bigint"
 }), BigIntFromSelf, {
   strict: true,
-  decode: (s, _, ast) => ParseResult.fromOption(bigInt_.fromString(s), () => new ParseResult.Type(ast, s)),
+  decode: (s, _, ast) => ParseResult.fromOption(bigInt_.fromString(s), () => new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a bigint`)),
   encode: n => ParseResult.succeed(String(n))
 }).annotations({
-  identifier: "bigint"
+  identifier: "BigInt"
 }) {}
 exports.BigInt = BigInt$;
 /**
@@ -3005,13 +3023,13 @@ const NonNegativeBigInt = exports.NonNegativeBigInt = /*#__PURE__*/BigInt$.pipe(
  * @since 3.10.0
  */
 class BigIntFromNumber extends /*#__PURE__*/transformOrFail(Number$.annotations({
-  description: "a number that will be parsed into a bigint"
+  description: "a number to be decoded into a bigint"
 }), BigIntFromSelf, {
   strict: true,
-  decode: (n, _, ast) => ParseResult.fromOption(bigInt_.fromNumber(n), () => new ParseResult.Type(ast, n)),
-  encode: (b, _, ast) => ParseResult.fromOption(bigInt_.toNumber(b), () => new ParseResult.Type(ast, b))
+  decode: (n, _, ast) => ParseResult.fromOption(bigInt_.fromNumber(n), () => new ParseResult.Type(ast, n, `Unable to decode ${n} into a bigint`)),
+  encode: (b, _, ast) => ParseResult.fromOption(bigInt_.toNumber(b), () => new ParseResult.Type(ast, b, `Unable to encode ${b}n into a number`))
 }).annotations({
-  identifier: "BigintFromNumber"
+  identifier: "BigIntFromNumber"
 }) {}
 exports.BigIntFromNumber = BigIntFromNumber;
 const redactedArbitrary = value => fc => value(fc).map(redacted_.make);
@@ -3067,12 +3085,12 @@ class DurationFromSelf extends /*#__PURE__*/declare(duration_.isDuration, {
  */
 exports.DurationFromSelf = DurationFromSelf;
 class DurationFromNanos extends /*#__PURE__*/transformOrFail(BigIntFromSelf.annotations({
-  description: "a bigint that will be parsed into a Duration"
+  description: "a bigint to be decoded into a Duration"
 }), DurationFromSelf, {
   strict: true,
   decode: nanos => ParseResult.succeed(duration_.nanos(nanos)),
   encode: (duration, _, ast) => option_.match(duration_.toNanos(duration), {
-    onNone: () => ParseResult.fail(new ParseResult.Type(ast, duration)),
+    onNone: () => ParseResult.fail(new ParseResult.Type(ast, duration, `Unable to encode ${duration} into a bigint`)),
     onSome: val => ParseResult.succeed(val)
   })
 }).annotations({
@@ -3087,7 +3105,7 @@ class DurationFromNanos extends /*#__PURE__*/transformOrFail(BigIntFromSelf.anno
  */
 exports.DurationFromNanos = DurationFromNanos;
 class DurationFromMillis extends /*#__PURE__*/transform(Number$.annotations({
-  description: "a number that will be parsed into a Duration"
+  description: "a number to be decoded into a Duration"
 }), DurationFromSelf, {
   strict: true,
   decode: ms => duration_.millis(ms),
@@ -3117,7 +3135,7 @@ const HRTime = /*#__PURE__*/Tuple(element(NonNegativeInt).annotations({
  * @since 3.10.0
  */
 class Duration extends /*#__PURE__*/transform(HRTime.annotations({
-  description: "a tuple of seconds and nanos that will be parsed into a Duration"
+  description: "a tuple of seconds and nanos to be decoded into a Duration"
 }), DurationFromSelf, {
   strict: true,
   decode: ([seconds, nanos]) => duration_.nanos(BigInt(seconds) * BigInt(1e9) + BigInt(nanos)),
@@ -3259,7 +3277,7 @@ const Uint8 = exports.Uint8 = /*#__PURE__*/Number$.pipe( /*#__PURE__*/between(0,
   description: "a 8-bit unsigned integer"
 }));
 const Uint8Array$ = exports.Uint8Array = /*#__PURE__*/transform(Array$(Uint8).annotations({
-  description: "an array of 8-bit unsigned integers that will be parsed into a Uint8Array"
+  description: "an array of 8-bit unsigned integers to be decoded into a Uint8Array"
 }), Uint8ArrayFromSelf, {
   strict: true,
   decode: numbers => Uint8Array.from(numbers),
@@ -3268,7 +3286,7 @@ const Uint8Array$ = exports.Uint8Array = /*#__PURE__*/transform(Array$(Uint8).an
   identifier: "Uint8Array"
 });
 const makeUint8ArrayTransformation = (id, decode, encode) => transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a Uint8Array"
+  description: "a string to be decoded into a Uint8Array"
 }), Uint8ArrayFromSelf, {
   strict: true,
   decode: (s, _, ast) => either_.mapLeft(decode(s), decodeException => new ParseResult.Type(ast, s, decodeException.message)),
@@ -3393,16 +3411,22 @@ const MaxItemsSchemaId = exports.MaxItemsSchemaId = schemaId_.MaxItemsSchemaId;
  * @category ReadonlyArray filters
  * @since 3.10.0
  */
-const maxItems = (n, annotations) => self => self.pipe(filter(a => a.length <= n, {
-  schemaId: MaxItemsSchemaId,
-  title: `maxItems(${n})`,
-  description: `an array of at most ${n} item(s)`,
-  jsonSchema: {
-    maxItems: n
-  },
-  [AST.StableFilterAnnotationId]: true,
-  ...annotations
-}));
+const maxItems = (n, annotations) => self => {
+  const maxItems = Math.floor(n);
+  if (maxItems < 1) {
+    throw new Error(errors_.getInvalidArgumentErrorMessage(`Expected an integer greater than or equal to 1, actual ${n}`));
+  }
+  return self.pipe(filter(a => a.length <= maxItems, {
+    schemaId: MaxItemsSchemaId,
+    title: `maxItems(${maxItems})`,
+    description: `an array of at most ${maxItems} item(s)`,
+    jsonSchema: {
+      maxItems
+    },
+    [AST.StableFilterAnnotationId]: true,
+    ...annotations
+  }));
+};
 /**
  * @category schema id
  * @since 3.10.0
@@ -3413,17 +3437,23 @@ const ItemsCountSchemaId = exports.ItemsCountSchemaId = schemaId_.ItemsCountSche
  * @category ReadonlyArray filters
  * @since 3.10.0
  */
-const itemsCount = (n, annotations) => self => self.pipe(filter(a => a.length === n, {
-  schemaId: ItemsCountSchemaId,
-  title: `itemsCount(${n})`,
-  description: `an array of exactly ${n} item(s)`,
-  jsonSchema: {
-    minItems: n,
-    maxItems: n
-  },
-  [AST.StableFilterAnnotationId]: true,
-  ...annotations
-}));
+const itemsCount = (n, annotations) => self => {
+  const itemsCount = Math.floor(n);
+  if (itemsCount < 1) {
+    throw new Error(errors_.getInvalidArgumentErrorMessage(`Expected an integer greater than or equal to 1, actual ${n}`));
+  }
+  return self.pipe(filter(a => a.length === itemsCount, {
+    schemaId: ItemsCountSchemaId,
+    title: `itemsCount(${itemsCount})`,
+    description: `an array of exactly ${itemsCount} item(s)`,
+    jsonSchema: {
+      minItems: itemsCount,
+      maxItems: itemsCount
+    },
+    [AST.StableFilterAnnotationId]: true,
+    ...annotations
+  }));
+};
 /**
  * @category ReadonlyArray transformations
  * @since 3.10.0
@@ -3468,7 +3498,7 @@ const headNonEmpty = self => transform(self, getNumberIndexedAccess(typeSchema(s
 exports.headNonEmpty = headNonEmpty;
 const headOrElse = exports.headOrElse = /*#__PURE__*/(0, _Function.dual)(args => isSchema(args[0]), (self, fallback) => transformOrFail(self, getNumberIndexedAccess(typeSchema(self)), {
   strict: true,
-  decode: (as, _, ast) => as.length > 0 ? ParseResult.succeed(as[0]) : fallback ? ParseResult.succeed(fallback()) : ParseResult.fail(new ParseResult.Type(ast, as)),
+  decode: (as, _, ast) => as.length > 0 ? ParseResult.succeed(as[0]) : fallback ? ParseResult.succeed(fallback()) : ParseResult.fail(new ParseResult.Type(ast, as, "Unable to retrieve the first element of an empty array")),
   encode: a => ParseResult.succeed(array_.of(a))
 }));
 /**
@@ -3642,7 +3672,7 @@ class ValidDateFromSelf extends /*#__PURE__*/DateFromSelf.pipe( /*#__PURE__*/val
  */
 exports.ValidDateFromSelf = ValidDateFromSelf;
 class DateFromString extends /*#__PURE__*/transform(String$.annotations({
-  description: "a string that will be parsed into a Date"
+  description: "a string to be decoded into a Date"
 }), DateFromSelf, {
   strict: true,
   decode: s => new Date(s),
@@ -3667,7 +3697,7 @@ exports.Date = Date$;
  * @since 3.10.0
  */
 class DateFromNumber extends /*#__PURE__*/transform(Number$.annotations({
-  description: "a number that will be parsed into a Date"
+  description: "a number to be decoded into a Date"
 }), DateFromSelf, {
   strict: true,
   decode: n => new Date(n),
@@ -3686,13 +3716,15 @@ class DateTimeUtcFromSelf extends /*#__PURE__*/declare(u => dateTime.isDateTime(
   identifier: "DateTimeUtcFromSelf",
   description: "a DateTime.Utc instance",
   pretty: () => dateTime => dateTime.toString(),
-  arbitrary: () => fc => fc.date().map(date => dateTime.unsafeFromDate(date)),
+  arbitrary: () => fc => fc.date({
+    noInvalidDate: true
+  }).map(date => dateTime.unsafeFromDate(date)),
   equivalence: () => dateTime.Equivalence
 }) {}
 exports.DateTimeUtcFromSelf = DateTimeUtcFromSelf;
-const decodeDateTime = (input, _, ast) => ParseResult.try({
+const decodeDateTimeUtc = (input, _, ast) => ParseResult.try({
   try: () => dateTime.unsafeMake(input),
-  catch: () => new ParseResult.Type(ast, input)
+  catch: () => new ParseResult.Type(ast, input, `Unable to decode ${util_.formatUnknown(input)} into a DateTime.Utc`)
 });
 /**
  * Defines a schema that attempts to convert a `number` to a `DateTime.Utc` instance using the `DateTime.unsafeMake` constructor.
@@ -3701,10 +3733,10 @@ const decodeDateTime = (input, _, ast) => ParseResult.try({
  * @since 3.10.0
  */
 class DateTimeUtcFromNumber extends /*#__PURE__*/transformOrFail(Number$.annotations({
-  description: "a number that will be parsed into a DateTime.Utc"
+  description: "a number to be decoded into a DateTime.Utc"
 }), DateTimeUtcFromSelf, {
   strict: true,
-  decode: decodeDateTime,
+  decode: decodeDateTimeUtc,
   encode: dt => ParseResult.succeed(dateTime.toEpochMillis(dt))
 }).annotations({
   identifier: "DateTimeUtcFromNumber"
@@ -3717,10 +3749,10 @@ class DateTimeUtcFromNumber extends /*#__PURE__*/transformOrFail(Number$.annotat
  */
 exports.DateTimeUtcFromNumber = DateTimeUtcFromNumber;
 class DateTimeUtcFromDate extends /*#__PURE__*/transformOrFail(DateFromSelf.annotations({
-  description: "a Date that will be parsed into a DateTime.Utc"
+  description: "a Date to be decoded into a DateTime.Utc"
 }), DateTimeUtcFromSelf, {
   strict: true,
-  decode: decodeDateTime,
+  decode: decodeDateTimeUtc,
   encode: dt => ParseResult.succeed(dateTime.toDateUtc(dt))
 }).annotations({
   identifier: "DateTimeUtcFromDate"
@@ -3733,10 +3765,10 @@ class DateTimeUtcFromDate extends /*#__PURE__*/transformOrFail(DateFromSelf.anno
  */
 exports.DateTimeUtcFromDate = DateTimeUtcFromDate;
 class DateTimeUtc extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a DateTime.Utc"
+  description: "a string to be decoded into a DateTime.Utc"
 }), DateTimeUtcFromSelf, {
   strict: true,
-  decode: decodeDateTime,
+  decode: decodeDateTimeUtc,
   encode: dt => ParseResult.succeed(dateTime.formatIso(dt))
 }).annotations({
   identifier: "DateTimeUtc"
@@ -3744,7 +3776,7 @@ class DateTimeUtc extends /*#__PURE__*/transformOrFail(String$.annotations({
 exports.DateTimeUtc = DateTimeUtc;
 const timeZoneOffsetArbitrary = () => fc => fc.integer({
   min: -12 * 60 * 60 * 1000,
-  max: 12 * 60 * 60 * 1000
+  max: 14 * 60 * 60 * 1000
 }).map(dateTime.zoneMakeOffset);
 /**
  * Describes a schema that represents a `TimeZone.Offset` instance.
@@ -3766,7 +3798,7 @@ class TimeZoneOffsetFromSelf extends /*#__PURE__*/declare(dateTime.isTimeZoneOff
  */
 exports.TimeZoneOffsetFromSelf = TimeZoneOffsetFromSelf;
 class TimeZoneOffset extends /*#__PURE__*/transform(Number$.annotations({
-  description: "a number that will be parsed into a TimeZone.Offset"
+  description: "a number to be decoded into a TimeZone.Offset"
 }), TimeZoneOffsetFromSelf, {
   strict: true,
   decode: dateTime.zoneMakeOffset,
@@ -3796,12 +3828,12 @@ class TimeZoneNamedFromSelf extends /*#__PURE__*/declare(dateTime.isTimeZoneName
  */
 exports.TimeZoneNamedFromSelf = TimeZoneNamedFromSelf;
 class TimeZoneNamed extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a TimeZone.Named"
+  description: "a string to be decoded into a TimeZone.Named"
 }), TimeZoneNamedFromSelf, {
   strict: true,
   decode: (s, _, ast) => ParseResult.try({
     try: () => dateTime.zoneUnsafeMakeNamed(s),
-    catch: () => new ParseResult.Type(ast, s)
+    catch: () => new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a TimeZone.Named`)
   }),
   encode: tz => ParseResult.succeed(tz.id)
 }).annotations({
@@ -3812,19 +3844,20 @@ class TimeZoneNamed extends /*#__PURE__*/transformOrFail(String$.annotations({
  * @since 3.10.0
  */
 exports.TimeZoneNamed = TimeZoneNamed;
-const TimeZoneFromSelf = exports.TimeZoneFromSelf = /*#__PURE__*/Union(TimeZoneOffsetFromSelf, TimeZoneNamedFromSelf);
+class TimeZoneFromSelf extends /*#__PURE__*/Union(TimeZoneOffsetFromSelf, TimeZoneNamedFromSelf) {}
 /**
  * Defines a schema that attempts to convert a `string` to a `TimeZone` using the `DateTime.zoneFromString` constructor.
  *
  * @category TimeZone transformations
  * @since 3.10.0
  */
+exports.TimeZoneFromSelf = TimeZoneFromSelf;
 class TimeZone extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a TimeZone"
+  description: "a string to be decoded into a TimeZone"
 }), TimeZoneFromSelf, {
   strict: true,
   decode: (s, _, ast) => option_.match(dateTime.zoneFromString(s), {
-    onNone: () => ParseResult.fail(new ParseResult.Type(ast, s)),
+    onNone: () => ParseResult.fail(new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a TimeZone`)),
     onSome: ParseResult.succeed
   }),
   encode: tz => ParseResult.succeed(dateTime.zoneToString(tz))
@@ -3843,9 +3876,13 @@ class DateTimeZonedFromSelf extends /*#__PURE__*/declare(u => dateTime.isDateTim
   identifier: "DateTimeZonedFromSelf",
   description: "a DateTime.Zoned instance",
   pretty: () => dateTime => dateTime.toString(),
-  arbitrary: () => fc => fc.date().chain(date => timeZoneArbitrary(fc).map(timeZone => dateTime.unsafeMakeZoned(date, {
+  arbitrary: () => fc => fc.tuple(fc.integer({
+    // time zone db supports +/- 1000 years or so
+    min: -31536000000000,
+    max: 31536000000000
+  }), timeZoneArbitrary(fc)).map(([millis, timeZone]) => dateTime.unsafeMakeZoned(millis, {
     timeZone
-  }))),
+  })),
   equivalence: () => dateTime.Equivalence
 }) {}
 /**
@@ -3856,11 +3893,11 @@ class DateTimeZonedFromSelf extends /*#__PURE__*/declare(u => dateTime.isDateTim
  */
 exports.DateTimeZonedFromSelf = DateTimeZonedFromSelf;
 class DateTimeZoned extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a DateTime.Zoned"
+  description: "a string to be decoded into a DateTime.Zoned"
 }), DateTimeZonedFromSelf, {
   strict: true,
   decode: (s, _, ast) => option_.match(dateTime.makeZonedFromString(s), {
-    onNone: () => ParseResult.fail(new ParseResult.Type(ast, s)),
+    onNone: () => ParseResult.fail(new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a DateTime.Zoned`)),
     onSome: ParseResult.succeed
   }),
   encode: dt => ParseResult.succeed(dateTime.formatIsoZoned(dt))
@@ -4207,7 +4244,7 @@ const ReadonlyMapFromRecord = ({
   key: encodedBoundSchema(key),
   value
 }).annotations({
-  description: "a record that will be parsed into a ReadonlyMap"
+  description: "a record to be decoded into a ReadonlyMap"
 }), ReadonlyMapFromSelf({
   key,
   value: typeSchema(value)
@@ -4228,7 +4265,7 @@ const MapFromRecord = ({
   key: encodedBoundSchema(key),
   value
 }).annotations({
-  description: "a record that will be parsed into a Map"
+  description: "a record to be decoded into a Map"
 }), MapFromSelf({
   key,
   value: typeSchema(value)
@@ -4312,11 +4349,11 @@ class BigDecimalFromSelf extends /*#__PURE__*/declare(bigDecimal_.isBigDecimal,
  */
 exports.BigDecimalFromSelf = BigDecimalFromSelf;
 class BigDecimal extends /*#__PURE__*/transformOrFail(String$.annotations({
-  description: "a string that will be parsed into a BigDecimal"
+  description: "a string to be decoded into a BigDecimal"
 }), BigDecimalFromSelf, {
   strict: true,
-  decode: (num, _, ast) => bigDecimal_.fromString(num).pipe(option_.match({
-    onNone: () => ParseResult.fail(new ParseResult.Type(ast, num)),
+  decode: (s, _, ast) => bigDecimal_.fromString(s).pipe(option_.match({
+    onNone: () => ParseResult.fail(new ParseResult.Type(ast, s, `Unable to decode ${JSON.stringify(s)} into a BigDecimal`)),
     onSome: val => ParseResult.succeed(bigDecimal_.normalize(val))
   })),
   encode: val => ParseResult.succeed(bigDecimal_.format(bigDecimal_.normalize(val)))
@@ -4331,12 +4368,12 @@ class BigDecimal extends /*#__PURE__*/transformOrFail(String$.annotations({
  * @since 3.10.0
  */
 exports.BigDecimal = BigDecimal;
-class BigDecimalFromNumber extends /*#__PURE__*/transformOrFail(Number$.annotations({
-  description: "a number that will be parsed into a BigDecimal"
+class BigDecimalFromNumber extends /*#__PURE__*/transform(Number$.annotations({
+  description: "a number to be decoded into a BigDecimal"
 }), BigDecimalFromSelf, {
   strict: true,
-  decode: num => ParseResult.succeed(bigDecimal_.unsafeFromNumber(num)),
-  encode: val => ParseResult.succeed(bigDecimal_.unsafeToNumber(val))
+  decode: bigDecimal_.unsafeFromNumber,
+  encode: bigDecimal_.unsafeToNumber
 }).annotations({
   identifier: "BigDecimalFromNumber"
 }) {}
@@ -5893,4 +5930,28 @@ const go = (ast, path) => {
       }
   }
 };
+/** @ignore */
+class PropertyKey$ extends /*#__PURE__*/Union(String$, Number$, SymbolFromStruct).annotations({
+  identifier: "PropertyKey"
+}) {}
+exports.PropertyKey = PropertyKey$;
+/**
+ * @category ArrayFormatter
+ * @since 3.12.5
+ */
+class ArrayFormatterIssue extends /*#__PURE__*/Struct({
+  _tag: propertySignature(Literal("Pointer", "Unexpected", "Missing", "Composite", "Refinement", "Transformation", "Type", "Forbidden")).annotations({
+    description: "The tag identifying the type of parse issue"
+  }),
+  path: propertySignature(Array$(PropertyKey$)).annotations({
+    description: "The path to the property where the issue occurred"
+  }),
+  message: propertySignature(String$).annotations({
+    description: "A descriptive message explaining the issue"
+  })
+}).annotations({
+  identifier: "ArrayFormatterIssue",
+  description: "Represents an issue returned by the ArrayFormatter formatter"
+}) {}
+exports.ArrayFormatterIssue = ArrayFormatterIssue;
 //# sourceMappingURL=Schema.js.map