decoders 2.9.0-pre.1 → 2.9.0-pre.2

package/dist/index.cjs

@@ -478,6 +478,28 @@ function tuple(...decoders) {
   });
 }
 
+// src/lib/size-options.ts
+function bySizeOptions(options) {
+  const size = options.size;
+  const min2 = _nullishCoalesce(size, () => ( options.min));
+  const max2 = _nullishCoalesce(size, () => ( options.max));
+  const atLeast = min2 === max2 ? "" : "at least ";
+  const atMost = min2 === max2 ? "" : "at most ";
+  return (value) => {
+    const len = _nullishCoalesce(value.length, () => ( value.size));
+    if (typeof value === "string") {
+      if (min2 !== void 0 && len < min2)
+        return `Too short, must be ${atLeast}${min2} chars`;
+      if (max2 !== void 0 && len > max2)
+        return `Too long, must be ${atMost}${max2} chars`;
+    } else {
+      if (min2 !== void 0 && len < min2) return `Must have ${atLeast}${min2} items`;
+      if (max2 !== void 0 && len > max2) return `Must have ${atMost}${max2} items`;
+    }
+    return null;
+  };
+}
+
 // src/misc.ts
 function instanceOf(klass) {
   return define(
@@ -490,6 +512,9 @@ function instanceOf(klass) {
 function lazy(decoderFn) {
   return define((blob) => decoderFn().decode(blob));
 }
+function sized(decoder, options) {
+  return decoder.reject(bySizeOptions(options));
+}
 function prep(mapperFn, decoder) {
   return define((originalInput, _, err2) => {
     let blob;
@@ -748,18 +773,6 @@ function mapping(decoder) {
   return record(decoder).transform((obj) => new Map(Object.entries(obj)));
 }
 
-// src/lib/size-options.ts
-function bySizeOptions(options) {
-  const size = options.size;
-  const min = _nullishCoalesce(size, () => ( options.min));
-  const max = _nullishCoalesce(size, () => ( options.max));
-  const atLeast = min === max ? "" : "at least ";
-  const atMost = min === max ? "" : "at most ";
-  const tooShort = min !== void 0 && `Too short, must be ${atLeast}${min} chars`;
-  const tooLong = max !== void 0 && `Too long, must be ${atMost}${max} chars`;
-  return tooShort && tooLong ? (s) => s.length < min ? tooShort : s.length > max ? tooLong : null : tooShort ? (s) => s.length < min ? tooShort : null : tooLong ? (s) => s.length > max ? tooLong : null : () => null;
-}
-
 // src/strings.ts
 var url_re = /^([A-Za-z]{2,12}(?:[+][A-Za-z]{2,12})?):\/\/(?:([^@:]*:?(?:[^@]+)?)@)?(?:([A-Za-z0-9.-]+)(?::([0-9]{2,5}))?)(\/(?:[-+~%/.,\w]*)?(?:\?[-+=&;%@.,/\w]*)?(?:#[.,!/\w]*)?)?$/;
 var string = define(
@@ -786,6 +799,10 @@ var email = regex(
   /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
   "Must be email"
 );
+var urlString = string.refine(
+  (s) => URL.canParse(s),
+  "Must be URL"
+);
 var url = either(
   regex(url_re, "Must be URL").transform((value) => new URL(value)),
   instanceOf(URL)
@@ -799,9 +816,7 @@ var identifier = regex(
   "Must be valid identifier"
 );
 function nanoid(options) {
-  return regex(/^[a-z0-9_-]+$/i, "Must be nano ID").reject(
-    bySizeOptions(_nullishCoalesce(options, () => ( { size: 21 })))
-  );
+  return sized(regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), _nullishCoalesce(options, () => ( { size: 21 })));
 }
 var uuid = regex(
   /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
@@ -857,6 +872,17 @@ var positiveInteger = integer.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
+function min(min2, decoder = number) {
+  return decoder.reject((value) => value < min2 ? `Must be at least ${min2}` : null);
+}
+function max(max2, decoder = number) {
+  return decoder.reject((value) => value > max2 ? `Must be at most ${max2}` : null);
+}
+function between(min2, max2, decoder = number) {
+  return decoder.reject(
+    (value) => value < min2 ? `Must be at least ${min2}` : value > max2 ? `Must be at most ${max2}` : null
+  );
+}
 var bigint = define(
   (blob, ok2, err2) => isBigInt(blob) ? ok2(blob) : err2("Must be bigint")
 );
@@ -944,5 +970,10 @@ var json = either(
 
 
 
-exports._annotate = public_annotate; exports.always = always; exports.anyNumber = anyNumber; exports.anything = anything; exports.array = array; exports.bigint = bigint; exports.boolean = boolean; exports.constant = constant; exports.date = date; exports.dateString = dateString; exports.datelike = datelike; exports.decimal = decimal; exports.define = define; exports.either = either; exports.email = email; exports.endsWith = endsWith; exports.enum_ = enum_; exports.err = err; exports.exact = exact; exports.fail = fail; exports.formatInline = formatInline; exports.formatShort = formatShort; exports.hexadecimal = hexadecimal; exports.httpsUrl = httpsUrl; exports.identifier = identifier; exports.inexact = inexact; exports.instanceOf = instanceOf; exports.integer = integer; exports.isDate = isDate; exports.isDecoder = isDecoder; exports.isPlainObject = isPlainObject; exports.isPromiseLike = isPromiseLike; exports.iso8601 = iso8601; exports.json = json; exports.jsonArray = jsonArray; exports.jsonObject = jsonObject; exports.lazy = lazy; exports.mapping = mapping; exports.nanoid = nanoid; exports.never = never; exports.nonEmptyArray = nonEmptyArray; exports.nonEmptyString = nonEmptyString; exports.null_ = null_; exports.nullable = nullable; exports.nullish = nullish; exports.number = number; exports.numeric = numeric; exports.object = object; exports.ok = ok; exports.oneOf = oneOf; exports.optional = optional; exports.poja = poja; exports.pojo = pojo; exports.positiveInteger = positiveInteger; exports.positiveNumber = positiveNumber; exports.prep = prep; exports.record = record; exports.regex = regex; exports.select = select; exports.setFromArray = setFromArray; exports.startsWith = startsWith; exports.string = string; exports.taggedUnion = taggedUnion; exports.truthy = truthy; exports.tuple = tuple; exports.undefined_ = undefined_; exports.unknown = unknown; exports.url = url; exports.uuid = uuid; exports.uuidv1 = uuidv1; exports.uuidv4 = uuidv4;
+
+
+
+
+
+exports._annotate = public_annotate; exports.always = always; exports.anyNumber = anyNumber; exports.anything = anything; exports.array = array; exports.between = between; exports.bigint = bigint; exports.boolean = boolean; exports.constant = constant; exports.date = date; exports.dateString = dateString; exports.datelike = datelike; exports.decimal = decimal; exports.define = define; exports.either = either; exports.email = email; exports.endsWith = endsWith; exports.enum_ = enum_; exports.err = err; exports.exact = exact; exports.fail = fail; exports.formatInline = formatInline; exports.formatShort = formatShort; exports.hexadecimal = hexadecimal; exports.httpsUrl = httpsUrl; exports.identifier = identifier; exports.inexact = inexact; exports.instanceOf = instanceOf; exports.integer = integer; exports.isDate = isDate; exports.isDecoder = isDecoder; exports.isPlainObject = isPlainObject; exports.isPromiseLike = isPromiseLike; exports.iso8601 = iso8601; exports.json = json; exports.jsonArray = jsonArray; exports.jsonObject = jsonObject; exports.lazy = lazy; exports.mapping = mapping; exports.max = max; exports.min = min; exports.nanoid = nanoid; exports.never = never; exports.nonEmptyArray = nonEmptyArray; exports.nonEmptyString = nonEmptyString; exports.null_ = null_; exports.nullable = nullable; exports.nullish = nullish; exports.number = number; exports.numeric = numeric; exports.object = object; exports.ok = ok; exports.oneOf = oneOf; exports.optional = optional; exports.poja = poja; exports.pojo = pojo; exports.positiveInteger = positiveInteger; exports.positiveNumber = positiveNumber; exports.prep = prep; exports.record = record; exports.regex = regex; exports.select = select; exports.setFromArray = setFromArray; exports.sized = sized; exports.startsWith = startsWith; exports.string = string; exports.taggedUnion = taggedUnion; exports.truthy = truthy; exports.tuple = tuple; exports.undefined_ = undefined_; exports.unknown = unknown; exports.url = url; exports.urlString = urlString; exports.uuid = uuid; exports.uuidv1 = uuidv1; exports.uuidv4 = uuidv4;
 // istanbul ignore else -- @preserve

package/dist/index.d.cts

@@ -398,11 +398,41 @@ declare const jsonArray: Decoder<JSONArray>;
  */
 declare const json: Decoder<JSONValue>;
 
+/**
+ * Forces TypeScript to "evaluate" named helper types, making API signatures
+ * clearer in IDEs.
+ *
+ * @see https://effectivetypescript.com/2022/02/25/gentips-4-display/
+ */
+type Resolve$1<T> = T extends (...args: unknown[]) => unknown ? T : {
+    [K in keyof T]: T[K];
+};
+/**
+ * Relaxes a discriminated union type definition, by explicitly adding
+ * properties defined in any other member as optional `never`.
+ *
+ * This makes accessing the members much more relaxed in TypeScript.
+ */
+type Relax<T> = DistributiveRelax<T, T extends any ? keyof T : never>;
+type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ? Resolve$1<{
+    [K in keyof T]: T[K];
+} & {
+    [K in Exclude<Ks, keyof T>]?: never;
+}> : never;
+
 type SizeOptions = {
     min?: number;
     max?: number;
     size?: number;
 };
+/**
+ * Anything with a .length or .size property, like strings, arrays, or sets.
+ */
+type Sized = Relax<{
+    length: number;
+} | {
+    size: number;
+}>;
 
 interface Klass<T> extends Function {
     new (...args: readonly any[]): T;
@@ -417,6 +447,10 @@ declare function instanceOf<K extends Klass<any>>(klass: K): Decoder<Instance<K>
  * types for recursive data structures.
  */
 declare function lazy<T>(decoderFn: () => Decoder<T>): Decoder<T>;
+/**
+ * Only accept strings, arrays, or sets with given length constraints.
+ */
+declare function sized<T extends Sized>(decoder: Decoder<T>, options: SizeOptions): Decoder<T>;
 /**
  * Pre-process the data input before passing it into the decoder. This gives
  * you the ability to arbitrarily customize the input on the fly before passing
@@ -450,6 +484,24 @@ declare const positiveNumber: Decoder<number>;
  * Accepts only non-negative (zero or positive) finite whole numbers.
  */
 declare const positiveInteger: Decoder<number>;
+/**
+ * Accepts numbers greater than or equal to the given minimum.
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``min(0, integer)``.
+ */
+declare function min(min: number, decoder?: Decoder<number>): Decoder<number>;
+/**
+ * Accepts numbers less than or equal to the given maximum.
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``max(100, integer)``.
+ */
+declare function max(max: number, decoder?: Decoder<number>): Decoder<number>;
+/**
+ * Accepts numbers within the given range (bounds are inclusive).
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``between(1, 10, integer)``.
+ */
+declare function between(min: number, max: number, decoder?: Decoder<number>): Decoder<number>;
 /**
  * Accepts any valid ``bigint`` value.
  */
@@ -535,6 +587,10 @@ declare function endsWith<S extends string>(suffix: S): Decoder<`${string}${S}`>
  * (This will not mean that the email address actually exist.)
  */
 declare const email: Decoder<string>;
+/**
+ * Accepts strings that are valid URLs.
+ */
+declare const urlString: Decoder<string>;
 /**
  * Accepts strings that are valid URLs, returns the value as a URL instance.
  */
@@ -660,4 +716,4 @@ declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
  */
 declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 
-export { type Annotation, type ArrayAnnotation, type DecodeResult, type Decoder, type DecoderType, type Err, type Formatter, type JSONArray, type JSONObject, type JSONValue, type ObjectAnnotation, type Ok, type OpaqueAnnotation, type Result, type Scalar, type ScalarAnnotation, type SizeOptions, public_annotate as _annotate, always, anyNumber, anything, array, bigint, boolean, constant, date, dateString, datelike, decimal, define, either, email, endsWith, enum_, err, exact, fail, formatInline, formatShort, hexadecimal, httpsUrl, identifier, inexact, instanceOf, integer, isDate, isDecoder, isPlainObject, isPromiseLike, iso8601, json, jsonArray, jsonObject, lazy, mapping, nanoid, never, nonEmptyArray, nonEmptyString, null_, nullable, nullish, number, numeric, object, ok, oneOf, optional, poja, pojo, positiveInteger, positiveNumber, prep, record, regex, select, setFromArray, startsWith, string, taggedUnion, truthy, tuple, undefined_, unknown, url, uuid, uuidv1, uuidv4 };
+export { type Annotation, type ArrayAnnotation, type DecodeResult, type Decoder, type DecoderType, type Err, type Formatter, type JSONArray, type JSONObject, type JSONValue, type ObjectAnnotation, type Ok, type OpaqueAnnotation, type Result, type Scalar, type ScalarAnnotation, type SizeOptions, type Sized, public_annotate as _annotate, always, anyNumber, anything, array, between, bigint, boolean, constant, date, dateString, datelike, decimal, define, either, email, endsWith, enum_, err, exact, fail, formatInline, formatShort, hexadecimal, httpsUrl, identifier, inexact, instanceOf, integer, isDate, isDecoder, isPlainObject, isPromiseLike, iso8601, json, jsonArray, jsonObject, lazy, mapping, max, min, nanoid, never, nonEmptyArray, nonEmptyString, null_, nullable, nullish, number, numeric, object, ok, oneOf, optional, poja, pojo, positiveInteger, positiveNumber, prep, record, regex, select, setFromArray, sized, startsWith, string, taggedUnion, truthy, tuple, undefined_, unknown, url, urlString, uuid, uuidv1, uuidv4 };

package/dist/index.d.ts

@@ -398,11 +398,41 @@ declare const jsonArray: Decoder<JSONArray>;
  */
 declare const json: Decoder<JSONValue>;
 
+/**
+ * Forces TypeScript to "evaluate" named helper types, making API signatures
+ * clearer in IDEs.
+ *
+ * @see https://effectivetypescript.com/2022/02/25/gentips-4-display/
+ */
+type Resolve$1<T> = T extends (...args: unknown[]) => unknown ? T : {
+    [K in keyof T]: T[K];
+};
+/**
+ * Relaxes a discriminated union type definition, by explicitly adding
+ * properties defined in any other member as optional `never`.
+ *
+ * This makes accessing the members much more relaxed in TypeScript.
+ */
+type Relax<T> = DistributiveRelax<T, T extends any ? keyof T : never>;
+type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ? Resolve$1<{
+    [K in keyof T]: T[K];
+} & {
+    [K in Exclude<Ks, keyof T>]?: never;
+}> : never;
+
 type SizeOptions = {
     min?: number;
     max?: number;
     size?: number;
 };
+/**
+ * Anything with a .length or .size property, like strings, arrays, or sets.
+ */
+type Sized = Relax<{
+    length: number;
+} | {
+    size: number;
+}>;
 
 interface Klass<T> extends Function {
     new (...args: readonly any[]): T;
@@ -417,6 +447,10 @@ declare function instanceOf<K extends Klass<any>>(klass: K): Decoder<Instance<K>
  * types for recursive data structures.
  */
 declare function lazy<T>(decoderFn: () => Decoder<T>): Decoder<T>;
+/**
+ * Only accept strings, arrays, or sets with given length constraints.
+ */
+declare function sized<T extends Sized>(decoder: Decoder<T>, options: SizeOptions): Decoder<T>;
 /**
  * Pre-process the data input before passing it into the decoder. This gives
  * you the ability to arbitrarily customize the input on the fly before passing
@@ -450,6 +484,24 @@ declare const positiveNumber: Decoder<number>;
  * Accepts only non-negative (zero or positive) finite whole numbers.
  */
 declare const positiveInteger: Decoder<number>;
+/**
+ * Accepts numbers greater than or equal to the given minimum.
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``min(0, integer)``.
+ */
+declare function min(min: number, decoder?: Decoder<number>): Decoder<number>;
+/**
+ * Accepts numbers less than or equal to the given maximum.
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``max(100, integer)``.
+ */
+declare function max(max: number, decoder?: Decoder<number>): Decoder<number>;
+/**
+ * Accepts numbers within the given range (bounds are inclusive).
+ * Defaults to the ``number`` decoder if none is provided. Pass a
+ * different decoder to further restrict accepted values, e.g. ``between(1, 10, integer)``.
+ */
+declare function between(min: number, max: number, decoder?: Decoder<number>): Decoder<number>;
 /**
  * Accepts any valid ``bigint`` value.
  */
@@ -535,6 +587,10 @@ declare function endsWith<S extends string>(suffix: S): Decoder<`${string}${S}`>
  * (This will not mean that the email address actually exist.)
  */
 declare const email: Decoder<string>;
+/**
+ * Accepts strings that are valid URLs.
+ */
+declare const urlString: Decoder<string>;
 /**
  * Accepts strings that are valid URLs, returns the value as a URL instance.
  */
@@ -660,4 +716,4 @@ declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
  */
 declare function isPlainObject(value: unknown): value is Record<string, unknown>;
 
-export { type Annotation, type ArrayAnnotation, type DecodeResult, type Decoder, type DecoderType, type Err, type Formatter, type JSONArray, type JSONObject, type JSONValue, type ObjectAnnotation, type Ok, type OpaqueAnnotation, type Result, type Scalar, type ScalarAnnotation, type SizeOptions, public_annotate as _annotate, always, anyNumber, anything, array, bigint, boolean, constant, date, dateString, datelike, decimal, define, either, email, endsWith, enum_, err, exact, fail, formatInline, formatShort, hexadecimal, httpsUrl, identifier, inexact, instanceOf, integer, isDate, isDecoder, isPlainObject, isPromiseLike, iso8601, json, jsonArray, jsonObject, lazy, mapping, nanoid, never, nonEmptyArray, nonEmptyString, null_, nullable, nullish, number, numeric, object, ok, oneOf, optional, poja, pojo, positiveInteger, positiveNumber, prep, record, regex, select, setFromArray, startsWith, string, taggedUnion, truthy, tuple, undefined_, unknown, url, uuid, uuidv1, uuidv4 };
+export { type Annotation, type ArrayAnnotation, type DecodeResult, type Decoder, type DecoderType, type Err, type Formatter, type JSONArray, type JSONObject, type JSONValue, type ObjectAnnotation, type Ok, type OpaqueAnnotation, type Result, type Scalar, type ScalarAnnotation, type SizeOptions, type Sized, public_annotate as _annotate, always, anyNumber, anything, array, between, bigint, boolean, constant, date, dateString, datelike, decimal, define, either, email, endsWith, enum_, err, exact, fail, formatInline, formatShort, hexadecimal, httpsUrl, identifier, inexact, instanceOf, integer, isDate, isDecoder, isPlainObject, isPromiseLike, iso8601, json, jsonArray, jsonObject, lazy, mapping, max, min, nanoid, never, nonEmptyArray, nonEmptyString, null_, nullable, nullish, number, numeric, object, ok, oneOf, optional, poja, pojo, positiveInteger, positiveNumber, prep, record, regex, select, setFromArray, sized, startsWith, string, taggedUnion, truthy, tuple, undefined_, unknown, url, urlString, uuid, uuidv1, uuidv4 };

package/dist/index.js

@@ -478,6 +478,28 @@ function tuple(...decoders) {
   });
 }
 
+// src/lib/size-options.ts
+function bySizeOptions(options) {
+  const size = options.size;
+  const min2 = size ?? options.min;
+  const max2 = size ?? options.max;
+  const atLeast = min2 === max2 ? "" : "at least ";
+  const atMost = min2 === max2 ? "" : "at most ";
+  return (value) => {
+    const len = value.length ?? value.size;
+    if (typeof value === "string") {
+      if (min2 !== void 0 && len < min2)
+        return `Too short, must be ${atLeast}${min2} chars`;
+      if (max2 !== void 0 && len > max2)
+        return `Too long, must be ${atMost}${max2} chars`;
+    } else {
+      if (min2 !== void 0 && len < min2) return `Must have ${atLeast}${min2} items`;
+      if (max2 !== void 0 && len > max2) return `Must have ${atMost}${max2} items`;
+    }
+    return null;
+  };
+}
+
 // src/misc.ts
 function instanceOf(klass) {
   return define(
@@ -490,6 +512,9 @@ function instanceOf(klass) {
 function lazy(decoderFn) {
   return define((blob) => decoderFn().decode(blob));
 }
+function sized(decoder, options) {
+  return decoder.reject(bySizeOptions(options));
+}
 function prep(mapperFn, decoder) {
   return define((originalInput, _, err2) => {
     let blob;
@@ -748,18 +773,6 @@ function mapping(decoder) {
   return record(decoder).transform((obj) => new Map(Object.entries(obj)));
 }
 
-// src/lib/size-options.ts
-function bySizeOptions(options) {
-  const size = options.size;
-  const min = size ?? options.min;
-  const max = size ?? options.max;
-  const atLeast = min === max ? "" : "at least ";
-  const atMost = min === max ? "" : "at most ";
-  const tooShort = min !== void 0 && `Too short, must be ${atLeast}${min} chars`;
-  const tooLong = max !== void 0 && `Too long, must be ${atMost}${max} chars`;
-  return tooShort && tooLong ? (s) => s.length < min ? tooShort : s.length > max ? tooLong : null : tooShort ? (s) => s.length < min ? tooShort : null : tooLong ? (s) => s.length > max ? tooLong : null : () => null;
-}
-
 // src/strings.ts
 var url_re = /^([A-Za-z]{2,12}(?:[+][A-Za-z]{2,12})?):\/\/(?:([^@:]*:?(?:[^@]+)?)@)?(?:([A-Za-z0-9.-]+)(?::([0-9]{2,5}))?)(\/(?:[-+~%/.,\w]*)?(?:\?[-+=&;%@.,/\w]*)?(?:#[.,!/\w]*)?)?$/;
 var string = define(
@@ -786,6 +799,10 @@ var email = regex(
   /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
   "Must be email"
 );
+var urlString = string.refine(
+  (s) => URL.canParse(s),
+  "Must be URL"
+);
 var url = either(
   regex(url_re, "Must be URL").transform((value) => new URL(value)),
   instanceOf(URL)
@@ -799,9 +816,7 @@ var identifier = regex(
   "Must be valid identifier"
 );
 function nanoid(options) {
-  return regex(/^[a-z0-9_-]+$/i, "Must be nano ID").reject(
-    bySizeOptions(options ?? { size: 21 })
-  );
+  return sized(regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), options ?? { size: 21 });
 }
 var uuid = regex(
   /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
@@ -857,6 +872,17 @@ var positiveInteger = integer.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
+function min(min2, decoder = number) {
+  return decoder.reject((value) => value < min2 ? `Must be at least ${min2}` : null);
+}
+function max(max2, decoder = number) {
+  return decoder.reject((value) => value > max2 ? `Must be at most ${max2}` : null);
+}
+function between(min2, max2, decoder = number) {
+  return decoder.reject(
+    (value) => value < min2 ? `Must be at least ${min2}` : value > max2 ? `Must be at most ${max2}` : null
+  );
+}
 var bigint = define(
   (blob, ok2, err2) => isBigInt(blob) ? ok2(blob) : err2("Must be bigint")
 );
@@ -878,6 +904,7 @@ export {
   anyNumber,
   anything,
   array,
+  between,
   bigint,
   boolean,
   constant,
@@ -911,6 +938,8 @@ export {
   jsonObject,
   lazy,
   mapping,
+  max,
+  min,
   nanoid,
   never,
   nonEmptyArray,
@@ -933,6 +962,7 @@ export {
   regex,
   select,
   setFromArray,
+  sized,
   startsWith,
   string,
   taggedUnion,
@@ -941,6 +971,7 @@ export {
   undefined_,
   unknown,
   url,
+  urlString,
   uuid,
   uuidv1,
   uuidv4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoders",
-  "version": "2.9.0-pre.1",
+  "version": "2.9.0-pre.2",
   "description": "Elegant and battle-tested validation library for type-safe input data for TypeScript",
   "license": "MIT",
   "repository": {
@@ -35,12 +35,11 @@
   ],
   "scripts": {
     "build": "tsup",
-    "docs:dev": "cd docs && npm run dev",
-    "docs:build": "cd docs && npm run build",
+    "docs": "npm run build && cp -r dist/ docs/decoders-latest-snapshot/ && cd docs && rm -rf .next && npm run dev",
     "docs:update-sources": "node bin/update-source-lines.js",
     "lint": "oxlint src/ test/ && prettier --list-different src/ test/ test-d/",
     "lint:package": "publint --strict && attw --pack",
-    "format": "oxlint --fix src/ test/ ; prettier --write src/ test/ test-d/",
+    "format": "oxlint --fix src/ test/ ; prettier --write src/ test/ test-d/ docs/content/ ; npm run docs:update-sources",
     "test": "vitest run --coverage",
     "test:completeness": "./bin/check.sh",
     "test:typescript": "tsc --noEmit",
@@ -67,7 +66,7 @@
     "@vitest/coverage-istanbul": "^4.0.18",
     "fast-check": "^4.5.3",
     "itertools": "^2.6.0",
-    "oxlint": "^1.50.0",
+    "oxlint": "^1.51.0",
     "pkg-pr-new": "^0.0.65",
     "prettier": "^3.8.1",
     "publint": "^0.3.18",