effect 4.0.0-beta.67 → 4.0.0-beta.68

package/dist/Schema.js

@@ -143,10 +143,7 @@ const TypeId = InternalSchema.TypeId;
  * **Example** (Schema for a parametric `Box<A>` type)
  *
  * ```ts
- * import { Effect, Schema } from "effect"
- * import * as SchemaParser from "effect/SchemaParser"
- * import * as Issue from "effect/SchemaIssue"
- * import * as Option from "effect/Option"
+ * import { Effect, Option, Schema, SchemaIssue as Issue, SchemaParser } from "effect"
  *
  * interface Box<A> {
  *   readonly value: A
@@ -173,7 +170,7 @@ const TypeId = InternalSchema.TypeId;
  * const schema = Box(Schema.Number)
  * ```
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function declareConstructor() {
@@ -207,8 +204,8 @@ export function declareConstructor() {
  *
  * @see {@link declareConstructor} for creating schemas for parametric types.
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function declare(is, annotations) {
   return declareConstructor()([], () => (input, ast) => is(input) ? Effect.succeed(input) : Effect.fail(new Issue.InvalidType(ast, Option_.some(input))), annotations);
@@ -237,6 +234,7 @@ export function declare(is, annotations) {
  * type E = typeof bottom["Encoded"]  // string
  * ```
  *
+ * @category utils
  * @since 4.0.0
  */
 export function revealBottom(bottom) {
@@ -265,7 +263,7 @@ export function revealBottom(bottom) {
  *
  * @see {@link annotateEncoded} to annotate the encoded side instead.
  *
- * @category Annotations
+ * @category annotations
  * @since 4.0.0
  */
 export function annotate(annotations) {
@@ -296,7 +294,7 @@ export function annotate(annotations) {
  *
  * @see {@link annotate} to annotate the type side instead.
  *
- * @category Annotations
+ * @category annotations
  * @since 4.0.0
  */
 export function annotateEncoded(annotations) {
@@ -327,7 +325,7 @@ export function annotateEncoded(annotations) {
  * })
  * ```
  *
- * @category Annotations
+ * @category annotations
  * @since 4.0.0
  */
 export function annotateKey(annotations) {
@@ -355,6 +353,7 @@ export function annotateKey(annotations) {
  * type Enc = typeof codec["Encoded"] // string
  * ```
  *
+ * @category utils
  * @since 4.0.0
  */
 export function revealCodec(codec) {
@@ -407,6 +406,7 @@ SchemaError };
  * }
  * ```
  *
+ * @category guards
  * @since 4.0.0
  */
 export function isSchemaError(u) {
@@ -550,7 +550,6 @@ function toBaseStandardJSONSchemaV1(self, target) {
  *
  * @category Standard Schema
  * @since 4.0.0
- * @experimental
  */
 export function toStandardJSONSchemaV1(self) {
   const jsonSchema = {
@@ -604,8 +603,8 @@ export function toStandardJSONSchemaV1(self) {
  * }
  * ```
  *
- * @category Asserting
- * @since 4.0.0
+ * @category guards
+ * @since 3.10.0
  */
 export const is = Parser.is;
 /**
@@ -621,27 +620,22 @@ export const is = Parser.is;
  * ```ts
  * import { Schema } from "effect"
  *
- * const assertString: (u: unknown) => asserts u is string = Schema.asserts(
- *   Schema.String
- * )
+ * const input: unknown = "hello"
  *
- * // This will pass silently (no return value)
- * try {
- *   assertString("hello")
- *   console.log("String assertion passed")
- * } catch (error) {
- *   console.log("String assertion failed")
- * }
+ * // This will pass silently (no return value) and narrow input to string
+ * Schema.asserts(Schema.String, input)
+ * console.log(input.toUpperCase())
  *
  * // This will throw an error
  * try {
- *   assertString(123)
+ *   const invalid: unknown = 123
+ *   Schema.asserts(Schema.String, invalid)
  * } catch (error) {
  *   console.log("Non-string assertion failed as expected")
  * }
  * ```
  *
- * @category Asserting
+ * @category guards
  * @since 4.0.0
  */
 export const asserts = Parser.asserts;
@@ -653,7 +647,7 @@ export const asserts = Parser.asserts;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export function decodeUnknownEffect(schema, options) {
@@ -670,7 +664,7 @@ export function decodeUnknownEffect(schema, options) {
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeEffect = decodeUnknownEffect;
@@ -683,7 +677,7 @@ export const decodeEffect = decodeUnknownEffect;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export function decodeUnknownExit(schema, options) {
@@ -701,7 +695,7 @@ export function decodeUnknownExit(schema, options) {
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeExit = decodeUnknownExit;
@@ -714,8 +708,8 @@ export const decodeExit = decodeUnknownExit;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
- * @since 4.0.0
+ * @category decoding
+ * @since 3.10.0
  */
 export const decodeUnknownOption = Parser.decodeUnknownOption;
 /**
@@ -725,8 +719,8 @@ export const decodeUnknownOption = Parser.decodeUnknownOption;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
- * @since 4.0.0
+ * @category decoding
+ * @since 3.10.0
  */
 export const decodeOption = Parser.decodeOption;
 /**
@@ -736,7 +730,7 @@ export const decodeOption = Parser.decodeOption;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeUnknownResult = Parser.decodeUnknownResult;
@@ -747,7 +741,7 @@ export const decodeUnknownResult = Parser.decodeUnknownResult;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeResult = Parser.decodeResult;
@@ -759,8 +753,8 @@ export const decodeResult = Parser.decodeResult;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
- * @since 4.0.0
+ * @category decoding
+ * @since 3.10.0
  */
 export const decodeUnknownPromise = Parser.decodeUnknownPromise;
 /**
@@ -772,8 +766,8 @@ export const decodeUnknownPromise = Parser.decodeUnknownPromise;
  * Options may be provided either when creating the decoder or when applying it;
  * application options override creation options.
  *
- * @category Decoding
- * @since 4.0.0
+ * @category decoding
+ * @since 3.10.0
  */
 export const decodePromise = Parser.decodePromise;
 /**
@@ -805,7 +799,7 @@ export const decodePromise = Parser.decodePromise;
  * //         └─ Expected a numeric string, actual "not a number"
  * ```
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeUnknownSync = Parser.decodeUnknownSync;
@@ -819,7 +813,7 @@ export const decodeUnknownSync = Parser.decodeUnknownSync;
  * provided either when creating the decoder or when applying it; application
  * options override creation options.
  *
- * @category Decoding
+ * @category decoding
  * @since 4.0.0
  */
 export const decodeSync = Parser.decodeSync;
@@ -842,7 +836,7 @@ export const decodeSync = Parser.decodeSync;
  * // Output: "42"
  * ```
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export function encodeUnknownEffect(schema, options) {
@@ -859,7 +853,7 @@ export function encodeUnknownEffect(schema, options) {
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeEffect = encodeUnknownEffect;
@@ -872,7 +866,7 @@ export const encodeEffect = encodeUnknownEffect;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export function encodeUnknownExit(schema, options) {
@@ -890,7 +884,7 @@ export function encodeUnknownExit(schema, options) {
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeExit = encodeUnknownExit;
@@ -903,8 +897,8 @@ export const encodeExit = encodeUnknownExit;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
- * @since 4.0.0
+ * @category encoding
+ * @since 3.10.0
  */
 export const encodeUnknownOption = Parser.encodeUnknownOption;
 /**
@@ -914,8 +908,8 @@ export const encodeUnknownOption = Parser.encodeUnknownOption;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
- * @since 4.0.0
+ * @category encoding
+ * @since 3.10.0
  */
 export const encodeOption = Parser.encodeOption;
 /**
@@ -925,7 +919,7 @@ export const encodeOption = Parser.encodeOption;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeUnknownResult = Parser.encodeUnknownResult;
@@ -936,7 +930,7 @@ export const encodeUnknownResult = Parser.encodeUnknownResult;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeResult = Parser.encodeResult;
@@ -948,8 +942,8 @@ export const encodeResult = Parser.encodeResult;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
- * @since 4.0.0
+ * @category encoding
+ * @since 3.10.0
  */
 export const encodeUnknownPromise = Parser.encodeUnknownPromise;
 /**
@@ -959,8 +953,8 @@ export const encodeUnknownPromise = Parser.encodeUnknownPromise;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
- * @since 4.0.0
+ * @category encoding
+ * @since 3.10.0
  */
 export const encodePromise = Parser.encodePromise;
 /**
@@ -973,7 +967,7 @@ export const encodePromise = Parser.encodePromise;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeUnknownSync = Parser.encodeUnknownSync;
@@ -984,7 +978,7 @@ export const encodeUnknownSync = Parser.encodeUnknownSync;
  * Options may be provided either when creating the encoder or when applying it;
  * application options override creation options.
  *
- * @category Encoding
+ * @category encoding
  * @since 4.0.0
  */
 export const encodeSync = Parser.encodeSync;
@@ -1000,8 +994,8 @@ export const encodeSync = Parser.encodeSync;
  * the bridge between the untyped AST representation and the strongly-typed
  * schema.
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const make = InternalSchema.make;
 /**
@@ -1022,6 +1016,7 @@ export const make = InternalSchema.make;
  * // "a"
  * ```
  *
+ * @category constructors
  * @since 4.0.0
  */
 export function asClass(schema) {
@@ -1032,8 +1027,8 @@ export function asClass(schema) {
 /**
  * Tests if a value is a `Schema`.
  *
- * @category Guards
- * @since 4.0.0
+ * @category guards
+ * @since 3.10.0
  */
 export function isSchema(u) {
   return Predicate.hasProperty(u, TypeId) && u[TypeId] === TypeId;
@@ -1057,6 +1052,7 @@ export function isSchema(u) {
  * type Person = typeof schema["Type"]
  * ```
  *
+ * @category combinators
  * @since 4.0.0
  */
 export const optionalKey = /*#__PURE__*/Struct_.lambda(schema => make(AST.optionalKey(schema.ast), {
@@ -1066,6 +1062,7 @@ export const optionalKey = /*#__PURE__*/Struct_.lambda(schema => make(AST.option
  * Reverses {@link optionalKey}, returning the inner required schema. Only
  * applicable to schemas already wrapped with `optionalKey`.
  *
+ * @category combinators
  * @since 4.0.0
  */
 export const requiredKey = /*#__PURE__*/Struct_.lambda(self => self.schema);
@@ -1092,20 +1089,23 @@ export const requiredKey = /*#__PURE__*/Struct_.lambda(self => self.schema);
  * type Person = typeof schema.Type
  * ```
  *
- * @since 4.0.0
+ * @category combinators
+ * @since 3.10.0
  */
 export const optional = /*#__PURE__*/Struct_.lambda(self => optionalKey(UndefinedOr(self)));
 /**
  * Reverses {@link optional}, returning the inner schema (unwrapping `UndefinedOr`).
  * Only applicable to schemas already wrapped with `optional`.
  *
- * @since 4.0.0
+ * @category combinators
+ * @since 3.10.0
  */
 export const required = /*#__PURE__*/Struct_.lambda(self => self.schema.members[0]);
 /**
  * Makes a struct field mutable (removes the `readonly` modifier on the property).
  * Use {@link readonlyKey} to reverse.
  *
+ * @category combinators
  * @since 4.0.0
  */
 export const mutableKey = /*#__PURE__*/Struct_.lambda(schema => make(AST.mutableKey(schema.ast), {
@@ -1115,6 +1115,7 @@ export const mutableKey = /*#__PURE__*/Struct_.lambda(schema => make(AST.mutable
  * Reverses {@link mutableKey}, returning the inner schema as readonly again.
  * Only applicable to schemas already wrapped with `mutableKey`.
  *
+ * @category combinators
  * @since 4.0.0
  */
 export const readonlyKey = /*#__PURE__*/Struct_.lambda(self => self.schema);
@@ -1122,6 +1123,7 @@ export const readonlyKey = /*#__PURE__*/Struct_.lambda(self => self.schema);
  * Extracts the type-side schema: sets `Encoded` to equal the decoded `Type`,
  * discarding the encoding transformation path.
  *
+ * @category transforming
  * @since 4.0.0
  */
 export const toType = /*#__PURE__*/Struct_.lambda(schema => make(AST.toType(schema.ast), {
@@ -1131,6 +1133,7 @@ export const toType = /*#__PURE__*/Struct_.lambda(schema => make(AST.toType(sche
  * Extracts the encoded-side schema: sets `Type` to equal the `Encoded`,
  * discarding the decoding transformation path.
  *
+ * @category transforming
  * @since 4.0.0
  */
 export const toEncoded = /*#__PURE__*/Struct_.lambda(schema => make(AST.toEncoded(schema.ast), {
@@ -1153,6 +1156,7 @@ export function flip(schema) {
  * Creates a schema for a single literal value (string, number, bigint, boolean, or null).
  *
  * **Example** (String literal)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1163,7 +1167,8 @@ export function flip(schema) {
  * @see {@link Literals} for a schema that represents a union of literals.
  * @see {@link tag} for a schema that represents a literal value that can be
  * used as a discriminator field in tagged unions and has a constructor default.
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function Literal(literal) {
   const out = make(new AST.Literal(literal), {
@@ -1185,6 +1190,7 @@ function templateLiteralFromParts(parts) {
  * a literal string/number/bigint or a schema whose encoded type is a string, number, or bigint.
  *
  * **Example** (URL path pattern)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1193,7 +1199,8 @@ function templateLiteralFromParts(parts) {
  * ```
  *
  * @see {@link TemplateLiteralParser} for a schema that also parses matched parts into a tuple.
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function TemplateLiteral(parts) {
   return make(templateLiteralFromParts(parts), {
@@ -1205,6 +1212,7 @@ export function TemplateLiteral(parts) {
  * one element per schema part.
  *
  * **Example** (Parse path parameters)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1213,7 +1221,8 @@ export function TemplateLiteral(parts) {
  * ```
  *
  * @see {@link TemplateLiteral} for a validation-only version that keeps the string encoded.
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function TemplateLiteralParser(parts) {
   return make(templateLiteralFromParts(parts).asTemplateLiteralParser(), {
@@ -1224,6 +1233,7 @@ export function TemplateLiteralParser(parts) {
  * Creates a schema from a TypeScript enum object. Validates that the input is one of the enum's values.
  *
  * **Example** (Direction enum)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1236,6 +1246,7 @@ export function TemplateLiteralParser(parts) {
  * // accepts "Up" or "Down"
  * ```
  *
+ * @category constructors
  * @since 4.0.0
  */
 export function Enum(enums) {
@@ -1246,40 +1257,46 @@ export function Enum(enums) {
 /**
  * Schema for the `never` type. Always fails validation — no value satisfies it.
  *
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Never = /*#__PURE__*/make(AST.never);
 /**
  * Schema for the `any` type. Accepts any value without validation.
  *
  * @see {@link Unknown} for a safer alternative that uses `unknown`.
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Any = /*#__PURE__*/make(AST.any);
 /**
  * Schema for the `unknown` type. Accepts any value without validation.
  *
  * @see {@link Any} for the `any` variant.
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Unknown = /*#__PURE__*/make(AST.unknown);
 /**
  * Schema for the `null` literal. Validates that the input is strictly `null`.
  *
  * @see {@link NullOr} for a union with another schema.
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Null = /*#__PURE__*/make(AST.null);
 /**
  * Schema for the `undefined` literal. Validates that the input is strictly `undefined`.
  *
  * @see {@link UndefinedOr} for a union with another schema.
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Undefined = /*#__PURE__*/make(AST.undefined);
 /**
  * Schema for `string` values. Validates that the input is `typeof` `"string"`.
  *
+ * @category schemas
  * @since 4.0.0
  */
 export const String = /*#__PURE__*/make(AST.string);
@@ -1292,6 +1309,7 @@ export const String = /*#__PURE__*/make(AST.string);
  * - Non-finite values are serialized as strings (`"NaN"`, `"Infinity"`, `"-Infinity"`).
  *
  * @see {@link Finite} for a schema that excludes non-finite values.
+ * @category schemas
  * @since 4.0.0
  */
 export const Number = /*#__PURE__*/make(AST.number);
@@ -1306,25 +1324,29 @@ export const Boolean = /*#__PURE__*/make(AST.boolean);
  * Schema for `symbol` values. Validates that the input is `typeof` `"symbol"`.
  *
  * @see {@link UniqueSymbol} for a schema that matches a specific symbol.
+ * @category schemas
  * @since 4.0.0
  */
 export const Symbol = /*#__PURE__*/make(AST.symbol);
 /**
  * Schema for `bigint` values. Validates that the input is `typeof` `"bigint"`.
  *
+ * @category schemas
  * @since 4.0.0
  */
 export const BigInt = /*#__PURE__*/make(AST.bigInt);
 /**
  * Schema for the `void` type. Accepts `undefined` as the encoded value.
  *
- * @since 4.0.0
+ * @category schemas
+ * @since 3.10.0
  */
 export const Void = /*#__PURE__*/make(AST.void);
 /**
  * Schema for the `object` type. Validates that the input is a non-null object or function
  * (i.e. `typeof value === "object" && value !== null || typeof value === "function"`).
  *
+ * @category schemas
  * @since 4.0.0
  */
 export const ObjectKeyword = /*#__PURE__*/make(AST.objectKeyword);
@@ -1332,6 +1354,7 @@ export const ObjectKeyword = /*#__PURE__*/make(AST.objectKeyword);
  * Creates a schema for a specific symbol. Only that exact symbol satisfies the schema.
  *
  * **Example** (Specific symbol)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1340,6 +1363,7 @@ export const ObjectKeyword = /*#__PURE__*/make(AST.objectKeyword);
  * ```
  *
  * @see {@link Symbol} for a schema that accepts any symbol.
+ * @category constructors
  * @since 4.0.0
  */
 export function UniqueSymbol(symbol) {
@@ -1382,8 +1406,8 @@ function makeStruct(ast, fields) {
  * // { name: 'Alice', age: 30 }
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function Struct(fields) {
   return makeStruct(AST.struct(fields, undefined), fields);
@@ -1404,6 +1428,7 @@ export function Struct(fields) {
  * ]).mapMembers(Tuple.map(Schema.fieldsAssign({ c: Schema.Number })))
  * ```
  *
+ * @category combinators
  * @since 4.0.0
  */
 export function fieldsAssign(fields) {
@@ -1430,7 +1455,7 @@ export function fieldsAssign(fields) {
  * // { name: 'Alice', age: 30 }
  * ```
  *
- * @category Struct transformations
+ * @category transforming
  * @since 4.0.0
  */
 export function encodeKeys(mapping) {
@@ -1478,8 +1503,8 @@ export function encodeKeys(mapping) {
  * // Alice Smith
  * ```
  *
+ * @category transforming
  * @since 4.0.0
- * @experimental
  */
 export function extendTo(/** The new fields to add */
 fields, /** A function per field to derive its value from the original input */
@@ -1534,8 +1559,8 @@ derive) {
  * // { a: 1, b: 2 }
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function Record(key, value, options) {
   const keyValueCombiner = options?.keyValueCombiner?.decode || options?.keyValueCombiner?.encode ? new AST.KeyValueCombiner(options.keyValueCombiner.decode, options.keyValueCombiner.encode) : undefined;
@@ -1562,7 +1587,7 @@ export function Record(key, value, options) {
  * type T = typeof schema.Type
  * ```
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function StructWithRest(schema, records) {
@@ -1595,8 +1620,8 @@ function makeTuple(ast, elements) {
  * // [ 'hello', 42 ]
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function Tuple(elements) {
   return makeTuple(AST.tuple(elements), elements);
@@ -1627,7 +1652,7 @@ export function Tuple(elements) {
  * // [ 'hello', 1, true, false ]
  * ```
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function TupleWithRest(schema, rest) {
@@ -1637,7 +1662,7 @@ export function TupleWithRest(schema, rest) {
   });
 }
 /**
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 const ArraySchema = /*#__PURE__*/Struct_.lambda(schema => make(new AST.Arrays(false, [], [schema.ast]), {
@@ -1659,7 +1684,7 @@ export {
  * // [ 'a', 'b', 'c' ]
  * ```
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 ArraySchema as Array };
@@ -1678,8 +1703,8 @@ ArraySchema as Array };
  * Schema.decodeUnknownSync(schema)([])          // throws
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const NonEmptyArray = /*#__PURE__*/Struct_.lambda(schema => make(new AST.Arrays(false, [schema.ast], [schema.ast]), {
   schema
@@ -1697,7 +1722,7 @@ export const NonEmptyArray = /*#__PURE__*/Struct_.lambda(schema => make(new AST.
  * arrays and arrays with two or more elements are encoded as arrays.
  *
  * @category Arrays
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function ArrayEnsure(schema) {
   return Union([schema, ArraySchema(schema)]).pipe(decodeTo(ArraySchema(toType(schema)), Transformation.transform({
@@ -1711,7 +1736,7 @@ export function ArrayEnsure(schema) {
  * The equivalence used to determine uniqueness is the one provided by
  * `Schema.toEquivalence(item)`.
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function UniqueArray(item) {
@@ -1731,7 +1756,8 @@ export function UniqueArray(item) {
  * type T = typeof schema.Type
  * ```
  *
- * @since 4.0.0
+ * @category transforming
+ * @since 3.10.0
  */
 export const mutable = /*#__PURE__*/Struct_.lambda(schema => {
   return make(new AST.Arrays(true, schema.ast.elements, schema.ast.rest), {
@@ -1766,8 +1792,8 @@ function makeUnion(ast, members) {
  * Schema.decodeUnknownSync(schema)(42)       // 42
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function Union(members, options) {
   return makeUnion(AST.union(members, options?.mode ?? "anyOf", undefined), members);
@@ -1776,6 +1802,7 @@ export function Union(members, options) {
  * Creates a union schema from an array of literal values.
  *
  * **Example** (Status codes)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1784,7 +1811,7 @@ export function Union(members, options) {
  * ```
  *
  * @see {@link Literal} for a schema that represents a single literal.
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function Literals(literals) {
@@ -1806,21 +1833,21 @@ export function Literals(literals) {
 /**
  * Creates a union schema of `S | null`.
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const NullOr = /*#__PURE__*/Struct_.lambda(self => Union([self, Null]));
 /**
  * Creates a union schema of `S | undefined`.
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const UndefinedOr = /*#__PURE__*/Struct_.lambda(self => Union([self, Undefined]));
 /**
  * Creates a union schema of `S | null | undefined`.
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const NullishOr = /*#__PURE__*/Struct_.lambda(self => Union([self, Null, Undefined]));
 /**
@@ -1829,6 +1856,7 @@ export const NullishOr = /*#__PURE__*/Struct_.lambda(self => Union([self, Null,
  * preventing infinite recursion during schema definition.
  *
  * **Example** (Recursive tree schema)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1843,8 +1871,8 @@ export const NullishOr = /*#__PURE__*/Struct_.lambda(self => Union([self, Null,
  * })
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function suspend(f) {
   return make(new AST.Suspend(() => f().ast));
@@ -1854,6 +1882,7 @@ export function suspend(f) {
  * changing the TypeScript type.
  *
  * **Example** (Adding checks to a schema)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -1862,7 +1891,7 @@ export function suspend(f) {
  * )
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export function check(...checks) {
@@ -1878,8 +1907,8 @@ export function check(...checks) {
  * names type-level failures before the refinement runs; it does not name the
  * failed refinement itself.
  *
- * @category Filtering
- * @since 4.0.0
+ * @category filtering
+ * @since 3.10.0
  */
 export function refine(refinement, annotations) {
   return schema => make(AST.appendChecks(schema.ast, [AST.makeFilterByGuard(refinement, annotations)]), {
@@ -1890,8 +1919,8 @@ export function refine(refinement, annotations) {
  * Adds a nominal brand to a schema, intersecting the output type with
  * `Brand.Brand<B>` to prevent accidental mixing of structurally identical types.
  *
- * @category Branding
- * @since 4.0.0
+ * @category branding
+ * @since 3.10.0
  */
 export function brand(identifier) {
   return schema => make(AST.brand(schema.ast, identifier), {
@@ -1903,8 +1932,8 @@ export function brand(identifier) {
  * Creates a branded schema from a {@link Brand.Constructor}, applying the
  * constructor's checks and brand tag to the underlying schema.
  *
- * @category Branding
- * @since 4.0.0
+ * @category branding
+ * @since 3.10.0
  */
 export function fromBrand(identifier, ctor) {
   return self => {
@@ -1931,6 +1960,7 @@ export function fromBrand(identifier, ctor) {
  * ```
  *
  * @see {@link catchDecoding} for a simpler error-recovery variant
+ * @category decoding
  * @since 4.0.0
  */
 export function middlewareDecoding(decode) {
@@ -1958,6 +1988,7 @@ export function middlewareDecoding(decode) {
  * ```
  *
  * @see {@link catchEncoding} for a simpler error-recovery variant
+ * @category encoding
  * @since 4.0.0
  */
 export function middlewareEncoding(encode) {
@@ -1982,6 +2013,7 @@ export function middlewareEncoding(encode) {
  * ```
  *
  * @see {@link catchDecodingWithContext} to add service requirements to the handler
+ * @category error handling
  * @since 4.0.0
  */
 export function catchDecoding(f) {
@@ -1990,6 +2022,7 @@ export function catchDecoding(f) {
 /**
  * Like {@link catchDecoding}, but the handler may require Effect services (`R`).
  *
+ * @category error handling
  * @since 4.0.0
  */
 export function catchDecodingWithContext(f) {
@@ -2002,6 +2035,7 @@ export function catchDecodingWithContext(f) {
  * succeeds with a fallback value or re-fails with a (possibly different) issue.
  *
  * @see {@link catchEncodingWithContext} to add service requirements to the handler
+ * @category error handling
  * @since 4.0.0
  */
 export function catchEncoding(f) {
@@ -2010,6 +2044,7 @@ export function catchEncoding(f) {
 /**
  * Like {@link catchEncoding}, but the handler may require Effect services (`R`).
  *
+ * @category error handling
  * @since 4.0.0
  */
 export function catchEncodingWithContext(f) {
@@ -2058,7 +2093,8 @@ export function decodeTo(to, transformation) {
  * // result: "hello"
  * ```
  *
- * @since 4.0.0
+ * @category transforming
+ * @since 3.10.0
  */
 export function decode(transformation) {
   return self => {
@@ -2090,7 +2126,8 @@ export function encodeTo(to, transformation) {
  * )
  * ```
  *
- * @since 4.0.0
+ * @category transforming
+ * @since 3.10.0
  */
 export function encode(transformation) {
   return self => {
@@ -2119,7 +2156,8 @@ export function encode(transformation) {
  * // value: { name: "anonymous" }
  * ```
  *
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function withConstructorDefault(
 // `S["~type.make.in"]` instead of `S["Type"]` is intentional here because
@@ -2158,6 +2196,7 @@ defaultValue) {
  *
  * @see {@link withDecodingDefault} for the value-level variant (key absent **or** `undefined`)
  * @see {@link withDecodingDefaultTypeKey} for the variant where the default is a `Type` value
+ * @category decoding
  * @since 4.0.0
  */
 export function withDecodingDefaultKey(defaultValue, options) {
@@ -2186,6 +2225,7 @@ export function withDecodingDefaultKey(defaultValue, options) {
  *
  * @see {@link withDecodingDefaultKey} for the variant where the default is an `Encoded` value
  * @see {@link withDecodingDefaultType} for the value-level variant
+ * @category decoding
  * @since 4.0.0
  */
 export function withDecodingDefaultTypeKey(defaultValue, options) {
@@ -2222,7 +2262,8 @@ export function withDecodingDefaultTypeKey(defaultValue, options) {
  *
  * @see {@link withDecodingDefaultKey} for the key-level variant (key absent only, not `undefined`)
  * @see {@link withDecodingDefaultType} for the variant where the default is a `Type` value
- * @since 4.0.0
+ * @category decoding
+ * @since 3.10.0
  */
 export function withDecodingDefault(defaultValue, options) {
   const encode = options?.encodingStrategy === "omit" ? Getter.omit() : Getter.passthrough();
@@ -2250,6 +2291,7 @@ export function withDecodingDefault(defaultValue, options) {
  *
  * @see {@link withDecodingDefault} for the variant where the default is an `Encoded` value
  * @see {@link withDecodingDefaultTypeKey} for the key-level variant
+ * @category decoding
  * @since 4.0.0
  */
 export function withDecodingDefaultType(defaultValue, options) {
@@ -2276,7 +2318,8 @@ export function withDecodingDefaultType(defaultValue, options) {
  *
  * @see {@link tagDefaultOmit} to also omit the tag during encoding
  * @see {@link TaggedStruct} for a shorthand that adds `_tag` automatically
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function tag(literal) {
   return Literal(literal).pipe(withConstructorDefault(Effect.succeed(literal)));
@@ -2302,6 +2345,7 @@ export function tag(literal) {
  * ```
  *
  * @see {@link tag} for the variant that keeps the tag during encoding
+ * @category constructors
  * @since 4.0.0
  */
 export function tagDefaultOmit(literal) {
@@ -2348,8 +2392,8 @@ export function tagDefaultOmit(literal) {
  * const literal = tagged.fields._tag.schema.literal
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function TaggedStruct(value, fields) {
   return Struct({
@@ -2378,8 +2422,8 @@ export function TaggedStruct(value, fields) {
  * ```
  *
  * @see {@link TaggedUnion} for a shorthand that builds the union from scratch
+ * @category combinators
  * @since 4.0.0
- * @experimental
  */
 export function toTaggedUnion(tag) {
   return self => {
@@ -2445,7 +2489,7 @@ export function toTaggedUnion(tag) {
  * ```
  *
  * @see {@link toTaggedUnion} to augment an existing union instead
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export function TaggedUnion(casesByTag) {
@@ -2488,6 +2532,7 @@ export function TaggedUnion(casesByTag) {
  * // person: Person
  * ```
  *
+ * @category constructors
  * @since 4.0.0
  */
 export function Opaque() {
@@ -2512,8 +2557,8 @@ export function Opaque() {
  * // decoded: Date
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export function instanceOf(constructor, annotations) {
   return declare(u => u instanceof constructor, annotations);
@@ -2522,6 +2567,7 @@ export function instanceOf(constructor, annotations) {
  * Constructs an `AST.Link` that describes how a value of type `T` encodes to and decodes from a `To` schema.
  * Used when building low-level AST transformations that bridge two schema types.
  *
+ * @category transforming
  * @since 4.0.0
  */
 export function link() {
@@ -3812,6 +3858,7 @@ export const isBetweenBigDecimal = /*#__PURE__*/makeIsBetween({
  * length.
  *
  * **Example** (Minimum length check)
+ *
  * ```ts
  * import { Schema } from "effect"
  *
@@ -4234,21 +4281,21 @@ export function isUnique(annotations) {
  * character.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const NonEmptyString = /*#__PURE__*/String.check(/*#__PURE__*/isNonEmpty());
 /**
  * A schema representing a single character.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Char = /*#__PURE__*/String.check(/*#__PURE__*/isLengthBetween(1, 1));
 /**
  * Creates a schema for `Option<A>`. See {@link Option} for details.
  *
  * @category Option
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function Option(value) {
   const schema = declareConstructor()([value], ([value]) => (input, ast, options) => {
@@ -4314,7 +4361,7 @@ export function Option(value) {
  * - `Some` is encoded as the value
  *
  * @category Option
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function OptionFromNullOr(schema) {
   return NullOr(schema).pipe(decodeTo(Option(toType(schema)), Transformation.optionFromNullOr()));
@@ -4331,7 +4378,7 @@ export function OptionFromNullOr(schema) {
  * - `Some` is encoded as the value
  *
  * @category Option
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function OptionFromUndefinedOr(schema) {
   return UndefinedOr(schema).pipe(decodeTo(Option(toType(schema)), Transformation.optionFromUndefinedOr()));
@@ -4348,7 +4395,7 @@ export function OptionFromUndefinedOr(schema) {
  * - `Some` is encoded as the value
  *
  * @category Option
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function OptionFromNullishOr(schema, options) {
   return NullishOr(schema).pipe(decodeTo(Option(toType(schema)), Transformation.optionFromNullishOr(options)));
@@ -4503,7 +4550,7 @@ export function Result(success, failure) {
  * but it will deserialize a value into a `Redacted` instance.
  *
  * @category Redacted
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function Redacted(value, options) {
   const decodeLabel = typeof options?.label === "string" ? Parser.decodeUnknownEffect(Literal(options.label)) : undefined;
@@ -4679,7 +4726,7 @@ function causeReasonToFormatter(error, defect) {
  * and unexpected defects.
  *
  * @category Cause
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function Cause(error, defect) {
   const schema = declareConstructor()([error, defect], ([error, defect]) => {
@@ -4744,7 +4791,7 @@ const ErrorJsonEncoded = /*#__PURE__*/Struct({
  * and decodes that object back into an `Error`. The stack trace is omitted from
  * the encoded form for security.
  *
- * @category Schemas
+ * @category schemas
  * @since 4.0.0
  */
 export const Error = /*#__PURE__*/instanceOf(globalThis.Error, {
@@ -4767,7 +4814,7 @@ export const Error = /*#__PURE__*/instanceOf(globalThis.Error, {
  * Encodes an `Error` as an object with `message`, optional `name`, and optional
  * `stack` properties, and decodes that object back into an `Error`.
  *
- * @category Schemas
+ * @category schemas
  * @since 4.0.0
  */
 export const ErrorWithStack = /*#__PURE__*/instanceOf(globalThis.Error, {
@@ -4799,8 +4846,8 @@ const defectTransformation = /*#__PURE__*/new Transformation.Transformation(/*#_
  * Unknown defects are serialized with `JSON.stringify` when possible and fall
  * back to Effect's formatted representation when JSON serialization fails.
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const Defect = /*#__PURE__*/Union([/*#__PURE__*/ErrorJsonEncoded.pipe(/*#__PURE__*/decodeTo(Error, /*#__PURE__*/Transformation.errorFromErrorJsonEncoded())), /*#__PURE__*/Any.pipe(/*#__PURE__*/decodeTo(/*#__PURE__*/Unknown.annotate({
   toCodecJson: () => link()(Any, defectTransformation),
@@ -4824,7 +4871,7 @@ export const DefectWithStack = /*#__PURE__*/Union([/*#__PURE__*/ErrorJsonEncoded
  * failure, and unexpected defect channels.
  *
  * @category Exit
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function Exit(value, error, defect) {
   const schema = declareConstructor()([value, error, defect], ([value, error, defect]) => {
@@ -4911,7 +4958,7 @@ export function Exit(value, error, defect) {
  * conform to the provided schemas.
  *
  * @category ReadonlyMap
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function ReadonlyMap(key, value) {
   const schema = declareConstructor()([key, value], ([key, value]) => {
@@ -4964,7 +5011,7 @@ export function ReadonlyMap(key, value) {
  * conform to the provided schemas.
  *
  * @category HashMap
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function HashMap(key, value) {
   const schema = declareConstructor()([key, value], ([key, value]) => {
@@ -5018,7 +5065,7 @@ export function HashMap(key, value) {
  * provided element schema.
  *
  * @category ReadonlySet
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function ReadonlySet(value) {
   const schema = declareConstructor()([value], ([value]) => {
@@ -5070,7 +5117,7 @@ export function ReadonlySet(value) {
  * provided schema.
  *
  * @category HashSet
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function HashSet(value) {
   const schema = declareConstructor()([value], ([value]) => {
@@ -5122,7 +5169,7 @@ export function HashSet(value) {
  * provided schema.
  *
  * @category Chunk
- * @since 4.0.0
+ * @since 3.10.0
  */
 export function Chunk(value) {
   const schema = declareConstructor()([value], ([value]) => {
@@ -5294,7 +5341,7 @@ export const Date = /*#__PURE__*/instanceOf(globalThis.Date, {
  * `"Invalid Date"`.
  *
  * @category Date
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const DateFromString = /*#__PURE__*/DateString.pipe(/*#__PURE__*/decodeTo(Date, Transformation.dateFromString));
 /**
@@ -5316,8 +5363,7 @@ export const DateValid = /*#__PURE__*/Date.check(/*#__PURE__*/isDateValid());
  * **Example** (Duration schema)
  *
  * ```ts
- * import { Schema } from "effect"
- * import { Duration } from "effect"
+ * import { Duration, Schema } from "effect"
  *
  * Schema.decodeUnknownSync(Schema.Duration)(Duration.seconds(5))
  * // => Duration(5s)
@@ -5325,7 +5371,7 @@ export const DateValid = /*#__PURE__*/Date.check(/*#__PURE__*/isDateValid());
  *
  * @category Duration
  *
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Duration = /*#__PURE__*/declare(Duration_.isDuration, {
   typeConstructor: {
@@ -5418,7 +5464,7 @@ const bigint0 = /*#__PURE__*/globalThis.BigInt(0);
  * `Duration.infinity`.
  *
  * @category Duration
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const DurationFromNanos = /*#__PURE__*/BigInt.check(isGreaterThanOrEqualToBigInt(bigint0)).pipe(/*#__PURE__*/decodeTo(Duration, Transformation.durationFromNanos));
 /**
@@ -5435,7 +5481,7 @@ export const DurationFromNanos = /*#__PURE__*/BigInt.check(isGreaterThanOrEqualT
  *   representing milliseconds
  *
  * @category Duration
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const DurationFromMillis = /*#__PURE__*/Number.check(isGreaterThanOrEqualTo(0)).pipe(/*#__PURE__*/decodeTo(Duration, Transformation.durationFromMillis));
 const BigDecimalString = /*#__PURE__*/String.annotate({
@@ -5449,7 +5495,7 @@ const BigDecimalString = /*#__PURE__*/String.annotate({
  * - encodes `BigDecimal` as a `string`
  *
  * @category BigDecimal
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const BigDecimal = /*#__PURE__*/declare(BigDecimal_.isBigDecimal, {
   typeConstructor: {
@@ -5493,7 +5539,7 @@ export const BigDecimalFromString = /*#__PURE__*/BigDecimalString.pipe(/*#__PURE
  * - Any value is encoded as a JSON string using `JSON.stringify`.
  * - If the value is not a valid JSON value, encoding fails.
  *
- * **Example**
+ * **Example** (Decoding unknown JSON strings)
  *
  * ```ts
  * import { Schema } from "effect"
@@ -5516,7 +5562,7 @@ export const UnknownFromJsonString = /*#__PURE__*/fromJsonString(Unknown);
  * The resulting schema first parses the input string as JSON, and then runs the
  * provided schema on the parsed result.
  *
- * **Example**
+ * **Example** (Decoding JSON strings with a schema)
  *
  * ```ts
  * import { Schema } from "effect"
@@ -5534,7 +5580,7 @@ export const UnknownFromJsonString = /*#__PURE__*/fromJsonString(Unknown);
  * resulting schema will be a JSON Schema with a `contentSchema` property that
  * contains the JSON Schema for the given schema.
  *
- * **Example**
+ * **Example** (Emitting JSON Schema for a JSON string decoder)
  *
  * ```ts
  * import { Schema } from "effect"
@@ -5759,6 +5805,7 @@ export const FormData = /*#__PURE__*/instanceOf(globalThis.FormData, {
  * // Success({"a":1}) // Note: the value is a number
  * ```
  *
+ * @category decoding
  * @since 4.0.0
  */
 export function fromFormData(schema) {
@@ -5860,6 +5907,7 @@ export const URLSearchParams = /*#__PURE__*/instanceOf(globalThis.URLSearchParam
  * // Success({"a":1}) // Note: the value is a number
  * ```
  *
+ * @category decoding
  * @since 4.0.0
  */
 export function fromURLSearchParams(schema) {
@@ -5869,14 +5917,14 @@ export function fromURLSearchParams(schema) {
  * A schema for finite numbers, rejecting `NaN`, `Infinity`, and `-Infinity`.
  *
  * @category Number
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Finite = /*#__PURE__*/Number.check(/*#__PURE__*/isFinite());
 /**
  * A schema for integers, rejecting `NaN`, `Infinity`, and `-Infinity`.
  *
  * @category Number
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Int = /*#__PURE__*/Number.check(/*#__PURE__*/isInt());
 /**
@@ -5892,7 +5940,7 @@ export const Int = /*#__PURE__*/Number.check(/*#__PURE__*/isInt());
  * A number is encoded as a `string`.
  *
  * @category Number
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const NumberFromString = /*#__PURE__*/String.annotate({
   expected: "a string that will be decoded as a number"
@@ -5930,7 +5978,7 @@ export const BigIntFromString = /*#__PURE__*/make(AST.bigIntString).pipe(/*#__PU
  * A schema for strings that contains no leading or trailing whitespaces.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Trimmed = /*#__PURE__*/String.check(/*#__PURE__*/isTrimmed());
 /**
@@ -5943,7 +5991,7 @@ export const Trimmed = /*#__PURE__*/String.check(/*#__PURE__*/isTrimmed());
  * - The trimmed string is encoded as is.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Trim = /*#__PURE__*/String.annotate({
   expected: "a string that will be decoded as a trimmed string"
@@ -5958,7 +6006,7 @@ export const Trim = /*#__PURE__*/String.annotate({
  * - A `string` is encoded as a base64-encoded string.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const StringFromBase64 = /*#__PURE__*/String.annotate({
   expected: "a base64 encoded string that will be decoded as a UTF-8 string"
@@ -5973,7 +6021,7 @@ export const StringFromBase64 = /*#__PURE__*/String.annotate({
  * - A `string` is encoded as a base64 (URL) encoded string.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const StringFromBase64Url = /*#__PURE__*/String.annotate({
   expected: "a base64 (URL) encoded string that will be decoded as a UTF-8 string"
@@ -5988,7 +6036,7 @@ export const StringFromBase64Url = /*#__PURE__*/String.annotate({
  * - A `string` is encoded as a hex string.
  *
  * @category String
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const StringFromHex = /*#__PURE__*/String.annotate({
   expected: "a hex encoded string that will be decoded as a UTF-8 string"
@@ -6003,7 +6051,7 @@ export const StringFromHex = /*#__PURE__*/String.annotate({
  * Encoding:
  * - A `string` is encoded as a URI component encoded string.
  *
- * **Example**
+ * **Example** (Decoding URI component strings)
  *
  * ```ts
  * import { Schema } from "effect"
@@ -6022,7 +6070,7 @@ export const StringFromHex = /*#__PURE__*/String.annotate({
  * ```
  *
  * @category String
- * @since 4.0.0
+ * @since 3.12.0
  */
 export const StringFromUriComponent = /*#__PURE__*/String.annotate({
   expected: "a URI component encoded string that will be decoded as a UTF-8 string"
@@ -6100,7 +6148,7 @@ export const Uint8Array = /*#__PURE__*/instanceOf(globalThis.Uint8Array, {
  * - A `Uint8Array` is encoded as a base64-encoded string.
  *
  * @category Uint8Array
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Uint8ArrayFromBase64 = /*#__PURE__*/Base64String.pipe(/*#__PURE__*/decodeTo(Uint8Array, Transformation.uint8ArrayFromBase64String));
 /**
@@ -6114,7 +6162,7 @@ export const Uint8ArrayFromBase64 = /*#__PURE__*/Base64String.pipe(/*#__PURE__*/
  * - A `Uint8Array` is encoded as a base64 (URL) encoded string.
  *
  * @category Uint8Array
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Uint8ArrayFromBase64Url = /*#__PURE__*/String.annotate({
   expected: "a base64 (URL) encoded string that will be decoded as a Uint8Array"
@@ -6133,7 +6181,7 @@ export const Uint8ArrayFromBase64Url = /*#__PURE__*/String.annotate({
  * - A `Uint8Array` is encoded as a hex encoded string.
  *
  * @category Uint8Array
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const Uint8ArrayFromHex = /*#__PURE__*/String.annotate({
   expected: "a hex encoded string that will be decoded as a Uint8Array"
@@ -6149,7 +6197,7 @@ export const Uint8ArrayFromHex = /*#__PURE__*/String.annotate({
  * - encodes `DateTime.Utc` as a UTC ISO string
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const DateTimeUtc = /*#__PURE__*/declare(u => DateTime.isDateTime(u) && DateTime.isUtc(u), {
   typeConstructor: {
@@ -6179,7 +6227,7 @@ export const DateTimeUtc = /*#__PURE__*/declare(u => DateTime.isDateTime(u) && D
  * - A `DateTime.Utc` is encoded as a `Date`
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.12.0
  */
 export const DateTimeUtcFromDate = /*#__PURE__*/DateValid.pipe(/*#__PURE__*/decodeTo(DateTimeUtc, {
   decode: /*#__PURE__*/Getter.dateTimeUtcFromInput(),
@@ -6227,7 +6275,7 @@ export const DateTimeUtcFromMillis = /*#__PURE__*/Number.pipe(/*#__PURE__*/decod
  * - encodes `DateTime.TimeZone.Offset` as a number (offset in milliseconds)
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const TimeZoneOffset = /*#__PURE__*/declare(DateTime.isTimeZoneOffset, {
   typeConstructor: {
@@ -6258,7 +6306,7 @@ const TimeZoneNamedString = /*#__PURE__*/String.annotate({
  * - encodes `DateTime.TimeZone.Named` as a string (IANA time zone identifier)
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const TimeZoneNamed = /*#__PURE__*/declare(DateTime.isTimeZoneNamed, {
   typeConstructor: {
@@ -6300,7 +6348,7 @@ const TimeZoneString = /*#__PURE__*/String.annotate({
  *   `+03:00`)
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const TimeZone = /*#__PURE__*/declare(DateTime.isTimeZone, {
   typeConstructor: {
@@ -6347,7 +6395,7 @@ const DateTimeZonedString = /*#__PURE__*/String.annotate({
  *   `YYYY-MM-DDTHH:mm:ss.sss+HH:MM[Time/Zone]`
  *
  * @category DateTime
- * @since 4.0.0
+ * @since 3.10.0
  */
 export const DateTimeZoned = /*#__PURE__*/declare(u => DateTime.isDateTime(u) && DateTime.isZoned(u), {
   typeConstructor: {
@@ -6525,8 +6573,8 @@ function isStruct(schema) {
  * console.log(dog.breed) // "Labrador"
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const Class = identifier => (schema, annotations) => {
   const struct = isStruct(schema) ? schema : Struct(schema);
@@ -6560,8 +6608,8 @@ export const Class = identifier => (schema, annotations) => {
  * console.log(c.radius) // 5
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const TaggedClass = identifier => {
   return (tagValue, schema, annotations) => {
@@ -6594,7 +6642,7 @@ export const TaggedClass = identifier => {
  * })
  * ```
  *
- * @category Constructors
+ * @category constructors
  * @since 4.0.0
  */
 export const ErrorClass = identifier => (schema, annotations) => {
@@ -6623,8 +6671,8 @@ export const ErrorClass = identifier => (schema, annotations) => {
  * })
  * ```
  *
- * @category Constructors
- * @since 4.0.0
+ * @category constructors
+ * @since 3.10.0
  */
 export const TaggedErrorClass = identifier => {
   return (tagValue, schema, annotations) => {