effect 4.0.0-beta.70 → 4.0.0-beta.71

package/dist/SchemaTransformation.js

@@ -99,7 +99,7 @@ import * as Issue from "./SchemaIssue.js";
  *
  * **When to use**
  *
- * - You need to catch or recover from parsing errors (e.g. `Schema.catchDecoding`).
+ * Use when you need to catch or recover from parsing errors (e.g. `Schema.catchDecoding`).
  * - You need to run side effects around the parsing pipeline.
  * - You need access to the full `Effect` rather than a single decoded value.
  *
@@ -155,7 +155,7 @@ const TypeId = "~effect/SchemaTransformation/Transformation";
  *
  * **When to use**
  *
- * - You need to define how a schema converts between two representations.
+ * Use when you need to define how a schema converts between two representations.
  * - You want to compose multiple transformations into a pipeline.
  * - You want to flip a transformation to swap decode/encode.
  *
@@ -211,7 +211,7 @@ export class Transformation {
  *
  * **When to use**
  *
- * - Checking whether a value is already a Transformation before wrapping it.
+ * Use to check whether a value is already a Transformation before wrapping it.
  *
  * **Details**
  *
@@ -245,7 +245,7 @@ export function isTransformation(u) {
  *
  * **When to use**
  *
- * - You already have `Getter` instances and want to pair them.
+ * Use when you already have `Getter` instances and want to pair them.
  * - You want idempotent wrapping (won't double-wrap).
  *
  * **Details**
@@ -283,7 +283,7 @@ export const make = options => {
  *
  * **When to use**
  *
- * - The transformation can fail (e.g. parsing, validation).
+ * Use when the transformation can fail (e.g. parsing, validation).
  * - The transformation requires Effect services.
  *
  * **Details**
@@ -329,7 +329,7 @@ export function transformOrFail(options) {
  *
  * **When to use**
  *
- * - The conversion cannot fail.
+ * Use when the conversion cannot fail.
  * - No Effect services are needed.
  *
  * **Details**
@@ -370,7 +370,7 @@ export function transform(options) {
  *
  * **When to use**
  *
- * - You need to produce or consume `Option.None` to represent absent keys.
+ * Use when you need to produce or consume `Option.None` to represent absent keys.
  * - You are working with optional struct fields.
  *
  * **Details**
@@ -414,7 +414,7 @@ export function transformOptional(options) {
  *
  * **When to use**
  *
- * - Normalizing user input by stripping leading/trailing whitespace.
+ * Use to normalize user input by stripping leading/trailing whitespace.
  *
  * **Details**
  *
@@ -448,7 +448,7 @@ export function trim() {
  *
  * **When to use**
  *
- * - Converting API field names between snake_case and camelCase conventions.
+ * Use to convert API field names between snake_case and camelCase conventions.
  *
  * **Details**
  *
@@ -481,7 +481,7 @@ export function snakeToCamel() {
  *
  * **When to use**
  *
- * - Normalizing strings to lowercase (e.g. email addresses).
+ * Use to normalize strings to lowercase (e.g. email addresses).
  *
  * **Details**
  *
@@ -514,7 +514,7 @@ export function toLowerCase() {
  *
  * **When to use**
  *
- * - Normalizing strings to uppercase (e.g. country codes).
+ * Use to normalize strings to uppercase (e.g. country codes).
  *
  * **Details**
  *
@@ -547,7 +547,7 @@ export function toUpperCase() {
  *
  * **When to use**
  *
- * - Normalizing display names or titles.
+ * Use to normalize display names or titles.
  *
  * **Details**
  *
@@ -579,7 +579,7 @@ export function capitalize() {
  *
  * **When to use**
  *
- * - Normalizing identifiers or field names.
+ * Use to normalize identifiers or field names.
  *
  * **Details**
  *
@@ -611,7 +611,7 @@ export function uncapitalize() {
  *
  * **When to use**
  *
- * - Parsing query-string-like or config-file-like strings into records.
+ * Use to parse query-string-like or config-file-like strings into records.
  *
  * **Details**
  *
@@ -659,7 +659,7 @@ export function passthroughSubtype() {
  *
  * **When to use**
  *
- * - Parsing numeric strings from APIs, form data, or URL parameters.
+ * Use to parse numeric strings from APIs, form data, or URL parameters.
  *
  * **Details**
  *
@@ -691,7 +691,7 @@ export const numberFromString = /*#__PURE__*/new Transformation(/*#__PURE__*/Get
  *
  * **When to use**
  *
- * - Parsing large integer strings (e.g. database IDs, blockchain values).
+ * Use to parse large integer strings (e.g. database IDs, blockchain values).
  *
  * **Details**
  *
@@ -721,7 +721,7 @@ export const bigintFromString = /*#__PURE__*/new Transformation(/*#__PURE__*/Get
  *
  * **When to use**
  *
- * - Parsing ISO 8601 date strings from APIs or user input.
+ * Use to parse ISO 8601 date strings from APIs or user input.
  *
  * **Details**
  *
@@ -752,7 +752,7 @@ export const dateFromString = /*#__PURE__*/new Transformation(/*#__PURE__*/Gette
  *
  * **When to use**
  *
- * - Parsing human-readable duration strings from APIs, config, or user input.
+ * Use to parse human-readable duration strings from APIs, config, or user input.
  *
  * **Details**
  *
@@ -792,7 +792,7 @@ export const durationFromString = /*#__PURE__*/transformOrFail({
  *
  * **When to use**
  *
- * - Working with nanosecond-precision timestamps or intervals.
+ * Use when working with nanosecond-precision timestamps or intervals.
  *
  * **Details**
  *
@@ -830,7 +830,7 @@ export const durationFromNanos = /*#__PURE__*/transformOrFail({
  *
  * **When to use**
  *
- * Use this for timeouts, delays, elapsed intervals, or other duration values
+ * Use when you use this for timeouts, delays, elapsed intervals, or other duration values
  * stored as millisecond counts.
  *
  * **Details**
@@ -882,7 +882,7 @@ export const errorFromErrorJsonEncoded = options => transform({
  *
  * **When to use**
  *
- * - Converting nullable API fields to `Option`.
+ * Use to convert nullable API fields to `Option`.
  *
  * **Details**
  *
@@ -920,7 +920,7 @@ export function optionFromNullOr() {
  *
  * **When to use**
  *
- * - Converting undefined-or API fields to `Option`.
+ * Use to convert undefined-or API fields to `Option`.
  *
  * **Details**
  *
@@ -960,7 +960,7 @@ export function optionFromUndefinedOr() {
  *
  * **When to use**
  *
- * - Converting nullish API fields to `Option` when both `null` and
+ * Use to convert nullish API fields to `Option` when both `null` and
  *   `undefined` represent absence.
  *
  * **Details**
@@ -1001,7 +1001,7 @@ export function optionFromNullishOr(options) {
  *
  * **When to use**
  *
- * - Converting optional struct keys (declared with `Schema.optionalKey`) to
+ * Use to convert optional struct keys (declared with `Schema.optionalKey`) to
  *   `Option` values.
  *
  * **Details**
@@ -1044,7 +1044,7 @@ export function optionFromOptionalKey() {
  *
  * **When to use**
  *
- * - Converting optional (possibly `undefined`) values to `Option`.
+ * Use to convert optional (possibly `undefined`) values to `Option`.
  *
  * **Details**
  *
@@ -1086,7 +1086,7 @@ export function optionFromOptional() {
  *
  * **When to use**
  *
- * - Parsing URL strings from user input or API responses.
+ * Use to parse URL strings from user input or API responses.
  *
  * **Details**
  *
@@ -1125,7 +1125,7 @@ export const urlFromString = /*#__PURE__*/transformOrFail({
  *
  * **When to use**
  *
- * - Parsing decimal number strings from APIs or user input.
+ * Use to parse decimal number strings from APIs or user input.
  *
  * **Details**
  *
@@ -1151,7 +1151,7 @@ export const bigDecimalFromString = /*#__PURE__*/transformOrFail({
  *
  * **When to use**
  *
- * - Handling binary data transmitted as Base64 strings (e.g. file uploads,
+ * Use when handling binary data transmitted as Base64 strings (e.g. file uploads,
  *   API payloads).
  *
  * **Details**
@@ -1182,7 +1182,7 @@ export const uint8ArrayFromBase64String = /*#__PURE__*/new Transformation(/*#__P
  *
  * **When to use**
  *
- * - Handling text data transmitted as Base64 strings.
+ * Use when handling text data transmitted as Base64 strings.
  *
  * **Details**
  *
@@ -1211,7 +1211,7 @@ export const stringFromBase64String = /*#__PURE__*/new Transformation(/*#__PURE_
  *
  * **When to use**
  *
- * - Handling text data transmitted as Base64 URL-safe strings.
+ * Use when handling text data transmitted as Base64 URL-safe strings.
  *
  * **Details**
  *
@@ -1240,7 +1240,7 @@ export const stringFromBase64UrlString = /*#__PURE__*/new Transformation(/*#__PU
  *
  * **When to use**
  *
- * - Handling text data transmitted as hexadecimal strings.
+ * Use when handling text data transmitted as hexadecimal strings.
  *
  * **Details**
  *
@@ -1270,7 +1270,7 @@ export const stringFromHexString = /*#__PURE__*/new Transformation(/*#__PURE__*/
  *
  * **When to use**
  *
- * - Storing structured data in URL query parameters or fragments.
+ * Use when storing structured data in URL query parameters or fragments.
  * - Composing with `Schema.parseJson` to round-trip JSON through a URL.
  *
  * **Details**
@@ -1302,7 +1302,7 @@ export const stringFromUriComponent = /*#__PURE__*/new Transformation(/*#__PURE_
  *
  * **When to use**
  *
- * Use this for JSON stored or transmitted as a string, usually before composing
+ * Use when you use this for JSON stored or transmitted as a string, usually before composing
  * with another schema that validates the parsed structure.
  *
  * **Details**
@@ -1333,7 +1333,7 @@ export const fromJsonString = /*#__PURE__*/new Transformation(/*#__PURE__*/Gette
  *
  * **When to use**
  *
- * Use this for form or multipart payloads where keys such as `user[name]` or
+ * Use when you use this for form or multipart payloads where keys such as `user[name]` or
  * `items[0]` should become nested data.
  *
  * **Details**
@@ -1365,7 +1365,7 @@ export const fromFormData = /*#__PURE__*/new Transformation(/*#__PURE__*/Getter.
  *
  * **When to use**
  *
- * Use this for query strings where keys such as `filter[name]` or `items[0]`
+ * Use when you use this for query strings where keys such as `filter[name]` or `items[0]`
  * should become nested data.
  *
  * **Details**
@@ -1395,11 +1395,19 @@ export const fromURLSearchParams = /*#__PURE__*/new Transformation(/*#__PURE__*/
  * Decodes a numeric time-zone offset in milliseconds into a
  * `DateTime.TimeZone.Offset` and encodes it back to the offset number.
  *
+ * **When to use**
+ *
+ * Use to represent fixed-offset time zones with numeric millisecond offsets in
+ * schema transformations or JSON codecs.
+ *
  * **Details**
  *
  * Decode uses `DateTime.zoneMakeOffset`; encode returns the offset's `offset`
  * field.
  *
+ * @see {@link timeZoneFromString} for IANA or offset string encodings
+ * @see {@link timeZoneNamedFromString} for IANA named-zone strings
+ *
  * @category transforming
  * @since 4.0.0
  */
@@ -1411,11 +1419,18 @@ export const timeZoneOffsetFromNumber = /*#__PURE__*/transform({
  * Decodes an IANA time-zone identifier string into a
  * `DateTime.TimeZone.Named` and encodes a named time zone back to its `id`.
  *
+ * **When to use**
+ *
+ * Use when a schema transformation should accept only IANA time-zone identifier
+ * strings and produce `DateTime.TimeZone.Named` values.
+ *
  * **Details**
  *
  * Decode fails with `InvalidValue` when the string is not a valid IANA time-zone
  * identifier.
  *
+ * @see {@link timeZoneFromString} for time-zone strings that may be either IANA identifiers or offset strings
+ *
  * @category transforming
  * @since 4.0.0
  */
@@ -1434,12 +1449,20 @@ export const timeZoneNamedFromString = /*#__PURE__*/transformOrFail({
  * Decodes a string into a `DateTime.TimeZone` and encodes a time zone back to
  * its string representation.
  *
+ * **When to use**
+ *
+ * Use when schema decoding should accept either an IANA time-zone identifier or
+ * an offset string and produce a general `DateTime.TimeZone`.
+ *
  * **Details**
  *
  * Accepted decode inputs include valid IANA identifiers and offset strings such
  * as `"+03:00"`. Decode fails with `InvalidValue` when the string cannot be
  * parsed as a time zone.
  *
+ * @see {@link timeZoneNamedFromString} for IANA named-zone strings only
+ * @see {@link timeZoneOffsetFromNumber} for fixed-offset zones encoded as numbers
+ *
  * @category transforming
  * @since 4.0.0
  */
@@ -1458,12 +1481,20 @@ export const timeZoneFromString = /*#__PURE__*/transformOrFail({
  * Decodes a date-time string into a `DateTime.Utc` and encodes it back to an ISO
  * string.
  *
+ * **When to use**
+ *
+ * Use to decode date-time strings when the schema value should be a normalized
+ * `DateTime.Utc` and encode back as a UTC ISO string.
+ *
  * **Details**
  *
  * Decode accepts strings supported by `DateTime.make`, converts the result to
  * UTC, and fails with `InvalidValue` when parsing fails. Encode uses
  * `DateTime.formatIso`.
  *
+ * @see {@link dateTimeZonedFromString} for ISO strings that should preserve zoned date-time information
+ * @see {@link dateFromString} for decoding into JavaScript `Date`
+ *
  * @category transforming
  * @since 4.0.0
  */
@@ -1482,12 +1513,19 @@ export const dateTimeUtcFromString = /*#__PURE__*/transformOrFail({
  * Decodes a zoned date-time string into a `DateTime.Zoned` and encodes it back
  * to an ISO zoned string.
  *
+ * **When to use**
+ *
+ * Use to define a schema transformation for ISO zoned date-time strings that
+ * decode to `DateTime.Zoned` and encode with `DateTime.formatIsoZoned`.
+ *
  * **Details**
  *
  * Decode uses `DateTime.makeZonedFromString` and fails with `InvalidValue` when
  * the input is not a valid zoned date-time. Encode uses
  * `DateTime.formatIsoZoned`.
  *
+ * @see {@link dateTimeUtcFromString} for date-time strings that should decode to `DateTime.Utc` and encode as UTC ISO strings
+ *
  * @category transforming
  * @since 4.0.0
  */

package/dist/SchemaTransformation.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaTransformation.js","names":["BigDecimal","DateTime","Duration","Effect","formatDate","Option","Predicate","Getter","Issue","Middleware","_tag","decode","encode","constructor","flip","TypeId","Transformation","compose","other","isTransformation","u","hasProperty","make","options","transformOrFail","transform","transformOptional","trim","passthrough","snakeToCamel","camelToSnake","toLowerCase","toUpperCase","capitalize","uncapitalize","splitKeyValue","joinKeyValue","passthrough_","passthroughSupertype","passthroughSubtype","numberFromString","Number","String","bigintFromString","BigInt","dateFromString","Date","durationFromString","s","match","fromInput","onNone","fail","InvalidValue","some","message","onSome","succeed","duration","globalThis","durationFromNanos","i","nanos","a","toNanos","durationFromMillis","millis","toMillis","errorFromErrorJsonEncoded","err","Error","name","stack","e","includeStack","optionFromNullOr","fromNullOr","getOrNull","optionFromUndefinedOr","fromUndefinedOr","getOrUndefined","optionFromNullishOr","fromNullishOr","onNoneEncoding","optionFromOptionalKey","flatten","optionFromOptional","ot","pipe","filter","isNotUndefined","urlFromString","try","URL","catch","url","href","bigDecimalFromString","result","fromString","isNone","value","bd","format","uint8ArrayFromBase64String","decodeBase64","encodeBase64","stringFromBase64String","decodeBase64String","stringFromBase64UrlString","decodeBase64UrlString","encodeBase64Url","stringFromHexString","decodeHexString","encodeHex","stringFromUriComponent","decodeUriComponent","encodeUriComponent","fromJsonString","parseJson","stringifyJson","fromFormData","decodeFormData","encodeFormData","fromURLSearchParams","decodeURLSearchParams","encodeURLSearchParams","timeZoneOffsetFromNumber","n","zoneMakeOffset","tz","offset","timeZoneNamedFromString","zoneMakeNamed","id","timeZoneFromString","zoneFromString","zoneToString","dateTimeUtcFromString","toUtc","utc","formatIso","dateTimeZonedFromString","makeZonedFromString","zoned","formatIsoZoned"],"sources":["../src/SchemaTransformation.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"SchemaTransformation.js","names":["BigDecimal","DateTime","Duration","Effect","formatDate","Option","Predicate","Getter","Issue","Middleware","_tag","decode","encode","constructor","flip","TypeId","Transformation","compose","other","isTransformation","u","hasProperty","make","options","transformOrFail","transform","transformOptional","trim","passthrough","snakeToCamel","camelToSnake","toLowerCase","toUpperCase","capitalize","uncapitalize","splitKeyValue","joinKeyValue","passthrough_","passthroughSupertype","passthroughSubtype","numberFromString","Number","String","bigintFromString","BigInt","dateFromString","Date","durationFromString","s","match","fromInput","onNone","fail","InvalidValue","some","message","onSome","succeed","duration","globalThis","durationFromNanos","i","nanos","a","toNanos","durationFromMillis","millis","toMillis","errorFromErrorJsonEncoded","err","Error","name","stack","e","includeStack","optionFromNullOr","fromNullOr","getOrNull","optionFromUndefinedOr","fromUndefinedOr","getOrUndefined","optionFromNullishOr","fromNullishOr","onNoneEncoding","optionFromOptionalKey","flatten","optionFromOptional","ot","pipe","filter","isNotUndefined","urlFromString","try","URL","catch","url","href","bigDecimalFromString","result","fromString","isNone","value","bd","format","uint8ArrayFromBase64String","decodeBase64","encodeBase64","stringFromBase64String","decodeBase64String","stringFromBase64UrlString","decodeBase64UrlString","encodeBase64Url","stringFromHexString","decodeHexString","encodeHex","stringFromUriComponent","decodeUriComponent","encodeUriComponent","fromJsonString","parseJson","stringifyJson","fromFormData","decodeFormData","encodeFormData","fromURLSearchParams","decodeURLSearchParams","encodeURLSearchParams","timeZoneOffsetFromNumber","n","zoneMakeOffset","tz","offset","timeZoneNamedFromString","zoneMakeNamed","id","timeZoneFromString","zoneFromString","zoneToString","dateTimeUtcFromString","toUtc","utc","formatIso","dateTimeZonedFromString","makeZonedFromString","zoned","formatIsoZoned"],"sources":["../src/SchemaTransformation.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/SchemaUtils.d.ts

@@ -3,12 +3,21 @@ import * as Schema from "./Schema.ts";
  * Builds an experimental schema for instances of a native class using a struct
  * schema as the encoded representation.
  *
+ * **When to use**
+ *
+ * Use when you need a schema for an existing native class while keeping a
+ * `Struct` schema as its encoded representation.
+ *
  * **Details**
  *
  * Decoding constructs `new constructor(props)` from the encoded fields.
  * Encoding uses the instance as the encoded shape, so the class should expose
  * properties compatible with the provided encoding schema.
  *
+ * @see {@link Schema.instanceOf} for validating existing class instances without a struct encoding
+ * @see {@link Schema.Class} for defining schema-backed classes directly
+ * @see {@link Schema.ErrorClass} for defining schema-backed error classes
+ *
  * @category schemas
  * @since 4.0.0
  */

package/dist/SchemaUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaUtils.d.ts","sourceRoot":"","sources":["../src/SchemaUtils.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAGrC;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,KAAI,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EACpH,WAAW,EAAE,CAAC,EACd,OAAO,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACvE,GACA,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CASlE"}
+{"version":3,"file":"SchemaUtils.d.ts","sourceRoot":"","sources":["../src/SchemaUtils.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAGrC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,KAAI,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EACpH,WAAW,EAAE,CAAC,EACd,OAAO,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACvE,GACA,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CASlE"}

package/dist/SchemaUtils.js

@@ -1,19 +1,37 @@
 /**
- * The `SchemaUtils` module contains focused helpers for schema patterns that
- * are useful but too specialized for the core `Schema` API surface.
+ * Focused schema helpers for patterns that are useful but too specialized for
+ * the main `Schema` module. This module currently covers the case where a
+ * native JavaScript or TypeScript class should decode from a plain struct and
+ * still remain an instance of that class after decoding.
  *
- * Use this module when you need to describe a native class with a schema while
- * keeping a plain struct as its encoded representation. This is especially
- * useful for classes such as `Data.Error` subclasses that should decode from
- * structured data, encode back to that data, and still preserve class identity
- * for instance checks and schema optics.
+ * **Mental model**
+ *
+ * - {@link getNativeClassSchema} starts from a constructor and a struct schema
+ *   for the encoded shape.
+ * - Decoding validates the struct, then calls the constructor with the decoded
+ *   fields as one object.
+ * - Encoding treats the instance as the encoded object, so instance properties
+ *   must line up with the struct fields.
+ * - The resulting schema preserves class identity through `Schema.instanceOf`
+ *   while retaining a plain-object representation for encoded data.
+ *
+ * **Common tasks**
+ *
+ * - Add schema support to an existing native class without rewriting it as a
+ *   `Schema.Class`.
+ * - Decode structured data into a `Data.Error` subclass or another class whose
+ *   constructor accepts a props object.
+ * - Encode class instances back to the struct shape expected at API, storage,
+ *   or transport boundaries.
  *
  * **Gotchas**
  *
- * - The constructor is called with the decoded struct fields as a single
- *   argument, so the class constructor must accept that shape.
- * - Encoding uses the instance itself as the encoded shape, so the instance
- *   should expose properties compatible with the provided struct schema.
+ * - Constructors that expect positional arguments are not compatible unless
+ *   they also accept the decoded props object.
+ * - Private fields or computed getters are not enough for encoding; the
+ *   instance must expose properties compatible with the provided struct schema.
+ * - Prefer `Schema.Class` or `Schema.ErrorClass` when you control the class
+ *   definition and do not need to adapt an existing constructor.
  *
  * @since 4.0.0
  */
@@ -24,12 +42,21 @@ import * as Transformation from "./SchemaTransformation.js";
  * Builds an experimental schema for instances of a native class using a struct
  * schema as the encoded representation.
  *
+ * **When to use**
+ *
+ * Use when you need a schema for an existing native class while keeping a
+ * `Struct` schema as its encoded representation.
+ *
  * **Details**
  *
  * Decoding constructs `new constructor(props)` from the encoded fields.
  * Encoding uses the instance as the encoded shape, so the class should expose
  * properties compatible with the provided encoding schema.
  *
+ * @see {@link Schema.instanceOf} for validating existing class instances without a struct encoding
+ * @see {@link Schema.Class} for defining schema-backed classes directly
+ * @see {@link Schema.ErrorClass} for defining schema-backed error classes
+ *
  * @category schemas
  * @since 4.0.0
  */

package/dist/SchemaUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaUtils.js","names":["identity","Schema","Transformation","getNativeClassSchema","constructor","options","transformation","transform","decode","props","encode","instanceOf","toCodec","link","encoding","annotations","pipe","encodeTo"],"sources":["../src/SchemaUtils.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBA,SAASA,QAAQ,QAAQ,eAAe;AACxC,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,OAAO,KAAKC,cAAc,MAAM,2BAA2B;AAE3D;;;;;;;;;;;;;AAaA,OAAM,SAAUC,oBAAoBA,CAClCC,WAAc,EACdC,OAGC;EAED,MAAMC,cAAc,GAAGJ,cAAc,CAACK,SAAS,CAA6B;IAC1EC,MAAM,EAAGC,KAAK,IAAK,IAAIL,WAAW,CAACK,KAAK,CAAC;IACzCC,MAAM,EAAEV;GACT,CAAC;EACF,OAAOC,MAAM,CAACU,UAAU,CAACP,WAAW,EAAE;IACpCQ,OAAO,EAAEA,CAAA,KAAMX,MAAM,CAACY,IAAI,EAAmB,CAACR,OAAO,CAACS,QAAQ,EAAER,cAAc,CAAC;IAC/E,GAAGD,OAAO,CAACU;GACZ,CAAC,CAACC,IAAI,CAACf,MAAM,CAACgB,QAAQ,CAACZ,OAAO,CAACS,QAAQ,EAAER,cAAc,CAAC,CAAC;AAC5D","ignoreList":[]}
+{"version":3,"file":"SchemaUtils.js","names":["identity","Schema","Transformation","getNativeClassSchema","constructor","options","transformation","transform","decode","props","encode","instanceOf","toCodec","link","encoding","annotations","pipe","encodeTo"],"sources":["../src/SchemaUtils.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAASA,QAAQ,QAAQ,eAAe;AACxC,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,OAAO,KAAKC,cAAc,MAAM,2BAA2B;AAE3D;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAM,SAAUC,oBAAoBA,CAClCC,WAAc,EACdC,OAGC;EAED,MAAMC,cAAc,GAAGJ,cAAc,CAACK,SAAS,CAA6B;IAC1EC,MAAM,EAAGC,KAAK,IAAK,IAAIL,WAAW,CAACK,KAAK,CAAC;IACzCC,MAAM,EAAEV;GACT,CAAC;EACF,OAAOC,MAAM,CAACU,UAAU,CAACP,WAAW,EAAE;IACpCQ,OAAO,EAAEA,CAAA,KAAMX,MAAM,CAACY,IAAI,EAAmB,CAACR,OAAO,CAACS,QAAQ,EAAER,cAAc,CAAC;IAC/E,GAAGD,OAAO,CAACU;GACZ,CAAC,CAACC,IAAI,CAACf,MAAM,CAACgB,QAAQ,CAACZ,OAAO,CAACS,QAAQ,EAAER,cAAc,CAAC,CAAC;AAC5D","ignoreList":[]}