@maxclicks/utilities 1.6.0 → 1.6.1

package/dist/types/Lazily.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Lazily.d.ts","sourceRoot":"","sources":["../../src/types/Lazily.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,MAAM,CAAC,MAAM,SAAS;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE;IACpE,CACE,UAAU,SAAS;QACjB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,CACtB,IAAI,EAAE;YAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;SAAE,EACrD,MAAM,EAAE;YAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;SAAE,KACpD,GAAG,CAAA;KACT,EAED,OAAO,EAAE,UAAU,GAClB,MAAM,CAAC,MAAM,GAAG;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;KAAE,CAAC,CAAA;IACvF,IAAI;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;KAAE,CAAA;CACpD;AAED,yBAAiB,MAAM,CAAC;IAEtB,SAAgB,MAAM,CAAC,OAAO,SAAS;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAA;KAAE,EAC1E,OAAO,EAAE,OAAO,GACf,MAAM,CAAC;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,OAAO,IAAI,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KAAE,CAAC,CAEjH;IAGD,SAAgB,qBAAqB,CAAC,aAAa,SAAS;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EACzF,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,aAAa,CAAC,CAIvB;CACF"}
+{"version":3,"file":"Lazily.d.ts","sourceRoot":"","sources":["../../src/types/Lazily.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,MAAM,CAAC,MAAM,SAAS;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE;IACpE,CACE,UAAU,SAAS;QACjB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,CACtB,IAAI,EAAE;YAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;SAAE,EACrD,MAAM,EAAE;YAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;SAAE,KACpD,GAAG,CAAA;KACT,EAED,OAAO,EAAE,UAAU,GAClB,MAAM,CAAC,MAAM,GAAG;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;KAAE,CAAC,CAAA;IACvF,IAAI;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;KAAE,CAAA;CACpD;AAED,yBAAiB,MAAM,CAAC;IACtB,2FAA2F;IAC3F,SAAgB,MAAM,CAAC,OAAO,SAAS;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAA;KAAE,EAC1E,OAAO,EAAE,OAAO,GACf,MAAM,CAAC;QAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,OAAO,IAAI,GAAG,SAAS,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KAAE,CAAC,CAEjH;IAED,uFAAuF;IACvF,SAAgB,qBAAqB,CAAC,aAAa,SAAS;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EACzF,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,aAAa,CAAC,CAIvB;CACF"}

package/dist/types/Lazily.js

@@ -1,10 +1,12 @@
 import { objectHelpers } from '../helpers/native/objectHelpers';
 export var Lazily;
 (function (Lazily) {
+    /** Creates a lazy object from getter functions. Getters starting with `$` are excluded. */
     function create(getters) {
         return createByGetters(getters);
     }
     Lazily.create = create;
+    /** Creates a lazy object from initial values, allowing extension with lazy getters. */
     function createByInitialValues(initialValues) {
         return createByGetters(objectHelpers.map(initialValues, (key, value) => (typeof value === 'function' ? () => value : value)));
     }

package/dist/types/Lazily.js.map

@@ -1 +1 @@
-{"version":3,"file":"Lazily.js","sourceRoot":"","sources":["../../src/types/Lazily.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAqD/D,MAAM,KAAW,MAAM,CAgBtB;AAhBD,WAAiB,MAAM;IAErB,SAAgB,MAAM,CACpB,OAAgB;QAEhB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAJe,aAAM,SAIrB,CAAA;IAGD,SAAgB,qBAAqB,CACnC,aAA4B;QAE5B,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CACtG,CAAA;IACH,CAAC;IANe,4BAAqB,wBAMpC,CAAA;AACH,CAAC,EAhBgB,MAAM,KAAN,MAAM,QAgBtB;AAED,SAAS,eAAe,CAAiD,OAExE;IACC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAS,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ;YAC/B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC;gBAAE,OAAO,SAAS,CAAA;YAClF,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;gBACnC,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAE,MAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACpG,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;QACnD,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,UAAU,UAAgB;QAC/B,IAAI,CAAC,UAAU;YAAE,OAAO,MAAM,CAAA;QAC9B,OAAO,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC,CAAA;IACvD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"Lazily.js","sourceRoot":"","sources":["../../src/types/Lazily.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAqD/D,MAAM,KAAW,MAAM,CAgBtB;AAhBD,WAAiB,MAAM;IACrB,2FAA2F;IAC3F,SAAgB,MAAM,CACpB,OAAgB;QAEhB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAJe,aAAM,SAIrB,CAAA;IAED,uFAAuF;IACvF,SAAgB,qBAAqB,CACnC,aAA4B;QAE5B,OAAO,eAAe,CACpB,aAAa,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CACtG,CAAA;IACH,CAAC;IANe,4BAAqB,wBAMpC,CAAA;AACH,CAAC,EAhBgB,MAAM,KAAN,MAAM,QAgBtB;AAED,SAAS,eAAe,CAAiD,OAExE;IACC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAS,EAAE;QAClC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ;YAC/B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC;gBAAE,OAAO,SAAS,CAAA;YAClF,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;gBACnC,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAE,MAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACpG,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;QACnD,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,UAAU,UAAgB;QAC/B,IAAI,CAAC,UAAU;YAAE,OAAO,MAAM,CAAA;QAC9B,OAAO,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC,CAAA;IACvD,CAAC,CAAA;AACH,CAAC"}

package/dist/types/Normalizer.d.ts

@@ -1,23 +1,51 @@
 import type { Falsy } from '../types';
+/**
+ * A composable validation and transformation pipeline for parsing input values.
+ *
+ * Normalizers can be chained to build complex validation logic:
+ * ```ts
+ * const emailNormalizer = Normalizer.stringTrimmed
+ *   .chain(value => value?.toLowerCase())
+ *   .chain(value => { if (!isValidEmail(value)) throw new Error('Invalid email'); return value })
+ * ```
+ */
 export declare class Normalizer<Value> {
     readonly parseOrThrow: Normalizer.ParseOrThrow<Value>;
     constructor(parseOrThrow: Normalizer.ParseOrThrow<Value>);
+    /** Runs the normalizer, returning a `Normalized` result with value or error. */
     normalize(value: any): Normalizer.Normalized<Value>;
+    /**
+     * Runs the normalizer, returning a `Normalized` result with value or error.
+     * Passes `undefined` as it is, suitable to normalized optional (not nullable) values.
+     */
     normalizeIfExists<V>(value: V): Normalizer.Normalized<undefined extends V ? Value | undefined : Value>;
+    /** Chains another synchronous transformation step. */
     chain<NewValue>(parseOrThrow: Normalizer.ParseOrThrow<NewValue, Value>): Normalizer<NewValue>;
+    /** Chains an asynchronous transformation step, converting to `Normalizer.Async`. */
     chainAsync<NewValue>(parseOrThrowAsync: Normalizer.ParseOrThrowAsync<NewValue, Value>): Normalizer.Async<NewValue>;
+    /** Creates a normalizer that throws if value is null, empty string, or empty array. */
     get required(): Normalizer<Exclude<Value, null>>;
 }
 export declare namespace Normalizer {
+    /** Async variant of `Normalizer` for pipelines with async steps. */
     class Async<Value> {
         readonly parseOrThrowAsync: ParseOrThrowAsync<Value>;
         constructor(parseOrThrowAsync: ParseOrThrowAsync<Value>);
+        /** Runs the async normalizer, returning a `Normalized` result. */
         normalize(value: any, abortSignal?: AbortSignal): Promise<Normalized<Value>>;
+        /**
+         * Runs the async normalizer, returning a `Normalized` result with value or error.
+         * Passes `undefined` as it is, suitable to normalized optional (not nullable) values.
+         */
         normalizeIfExists<V>(value: V, abortSignal?: AbortSignal): Promise<Normalized<undefined extends V ? Value | undefined : Value>>;
+        /** Chains a synchronous transformation step. */
         chain<NewValue>(parseOrThrow: ParseOrThrow<NewValue, Value>): Async<NewValue>;
+        /** Chains an asynchronous transformation step. */
         chainAsync<NewValue>(parseOrThrowAsync: ParseOrThrowAsync<NewValue, Value>): Async<NewValue>;
+        /** Creates an async normalizer that throws if value is null, empty string, or empty array. */
         get required(): Async<Exclude<Value, null>>;
     }
+    /** Result container holding either a normalized value (with optional warning) or an error. */
     class Normalized<Value> {
         private readonly state;
         constructor(state: {
@@ -29,14 +57,27 @@ export declare namespace Normalizer {
             readonly warningMessage?: string;
             readonly value: Value;
         });
+        /** Error message if normalization failed. */
         get errorMessage(): string | undefined;
+        /** Warning message if normalization succeeded with issues. */
         get warningMessage(): string | undefined;
+        /** The normalized value, or undefined if failed. Does not throw. */
         get valueSafe(): Value | undefined;
+        /** The normalized value. Throws if normalization failed. */
         get value(): Value;
+        /** Allows using `Normalized` in expressions expecting the value type. */
         valueOf(): Value;
+        /**
+         * Gets the value, passing any warning to the warn function.
+         * Throws with optional prefix if normalization failed.
+         */
         getValue(warn: Warn): Value;
         getValue(messagePrefix: string): Value;
         getValue(messagePrefix: string, warn: Warn): Value;
+        /**
+         * Combines multiple `Normalized` results into a single result.
+         * Aggregates all errors/warnings with optional labels.
+         */
         static combine<T extends {
             readonly [K in string]: any;
         } | readonly any[]>(normalizedItems: T, labelByKey?: {
@@ -46,38 +87,75 @@ export declare namespace Normalizer {
         }>;
     }
     namespace Normalized {
+        /**
+         * Use it with `satisfies`.
+         *
+         * @example
+         * interface Type {
+         *   key1: Type1
+         *   key2: Type2
+         *   key3: Type3
+         * }
+         * const items = {
+         *   key1: normalizer.normalize(value1),
+         *   key2: normalizer.normalize(value2),
+         *   key3: value3,
+         * } satisfies Normalizer.Normalized.Items<Type> // Helps with correctly defining items while not restricting the actual type definition.
+         * const combined = Normalizer.Normalized.combine(items) // combined.value is compatible with Type.
+         */
         type Items<T extends {
             readonly [K in string]: any;
         } | readonly any[]> = {
             -readonly [K in keyof T]: T[K] | Normalized<T[K]>;
         };
     }
+    /** Synchronous parser function signature. Throws on validation failure. */
     type ParseOrThrow<ToValue, FromValue = any> = (value: FromValue, warn: Warn) => ToValue;
+    /** Async parser function signature. Throws on validation failure. */
     type ParseOrThrowAsync<ToValue, FromValue = any> = (value: FromValue, warn: Warn, abortSignal: AbortSignal | undefined) => Promise<ToValue>;
+    /** Warning collector function passed to parsers. Call with a message to accumulate warnings. */
     interface Warn {
         (message: string | Falsy): void;
+        /** Accumulated warning messages joined by newlines. */
         readonly message: string | undefined;
     }
     namespace Warn {
+        /** Creates a new warning collector. */
         function create(): Warn;
     }
+    /** Passthrough normalizer that accepts any value unchanged. */
     const any: Normalizer<any>;
+    /** Normalizer that coerces to string. Returns null for empty strings. */
     const string: Normalizer<string | null>;
+    /** Normalizer that trims whitespace and warns if trimming occurred. */
     const stringTrimmed: Normalizer<string | null>;
+    /** Normalizer that trims and lowercases strings. */
     const stringTrimmedAndLowerCased: Normalizer<string | null>;
+    /** Creates a parser that warns if string length is outside bounds. */
     function stringLimitLength(minimum: number, maximum: number): ParseOrThrow<string | null, string | null>;
+    /** Creates a parser that validates string is a value from an enum object. */
     function stringEnum<E extends string>(enumObject: {
         readonly [K in string]: E;
     }): ParseOrThrow<E | null, string | null>;
+    /** Creates a parser that validates string is one of the allowed values. */
     function stringEnumValues<E extends readonly string[]>(...allowedValues: E): ParseOrThrow<E[number] | null, string | null>;
+    /** Normalizer that coerces to number. Throws for NaN. */
     const number: Normalizer<number | null>;
+    /** Normalizer that validates number is an integer. */
     const numberInteger: Normalizer<number | null>;
+    /** Creates a parser that warns if number is outside bounds. */
     function numberLimitRange(minimum: number, maximum: number): ParseOrThrow<number | null, number | null>;
+    /** Normalizer that coerces to boolean. Accepts `'true'`/`'false'` strings. */
     const boolean: Normalizer<boolean | null>;
+    /** Normalizer that validates value is a plain object (not array). */
     const object: Normalizer<Record<string, any> | null>;
+    /** Creates a parser that throws if object is missing required keys. */
     function objectRequireKeys(...keys: readonly string[]): ParseOrThrow<Record<string, any> | null, Record<string, any> | null>;
+    /** Simplifies normalization of object properties with a stronger type guarantee. */
     function objectProperties<T extends {}>(normalizeProperties: (value: T) => Normalized.Items<T>): ParseOrThrow<T | null, Record<string, any> | null>;
+    /** Normalizer that wraps non-array values in an array. Returns empty array for null. */
     const array: Normalizer<any[]>;
+    /** Simplifies normalization of array items with a stronger type guarantee. */
     function arrayItems<I>(itemNormalizer: Normalizer<I>): Normalizer.ParseOrThrow<I[], any[]>;
 }
 //# sourceMappingURL=Normalizer.d.ts.map

package/dist/types/Normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Normalizer.d.ts","sourceRoot":"","sources":["../../src/types/Normalizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Normalizer.d.ts","sourceRoot":"","sources":["../../src/types/Normalizer.ts"],"names":[],"mappings":"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"}

package/dist/types/Normalizer.js

@@ -3,10 +3,21 @@ import { getErrorMessage } from '../helpers/error-warning/getErrorMessage';
 import { prependMessage } from '../helpers/error-warning/prependMessage';
 import { arrayHelpers } from '../helpers/native/arrayHelpers';
 import { objectHelpers } from '../helpers/native/objectHelpers';
+/**
+ * A composable validation and transformation pipeline for parsing input values.
+ *
+ * Normalizers can be chained to build complex validation logic:
+ * ```ts
+ * const emailNormalizer = Normalizer.stringTrimmed
+ *   .chain(value => value?.toLowerCase())
+ *   .chain(value => { if (!isValidEmail(value)) throw new Error('Invalid email'); return value })
+ * ```
+ */
 export class Normalizer {
     constructor(parseOrThrow) {
         this.parseOrThrow = parseOrThrow;
     }
+    /** Runs the normalizer, returning a `Normalized` result with value or error. */
     normalize(value) {
         const warn = Normalizer.Warn.create();
         try {
@@ -24,6 +35,10 @@ export class Normalizer {
             });
         }
     }
+    /**
+     * Runs the normalizer, returning a `Normalized` result with value or error.
+     * Passes `undefined` as it is, suitable to normalized optional (not nullable) values.
+     */
     normalizeIfExists(value) {
         const warn = Normalizer.Warn.create();
         try {
@@ -39,12 +54,15 @@ export class Normalizer {
             });
         }
     }
+    /** Chains another synchronous transformation step. */
     chain(parseOrThrow) {
         return new Normalizer((value, warn) => parseOrThrow(this.parseOrThrow(value, warn), warn));
     }
+    /** Chains an asynchronous transformation step, converting to `Normalizer.Async`. */
     chainAsync(parseOrThrowAsync) {
         return new Normalizer.Async((value, warn, abortSignal) => parseOrThrowAsync(this.parseOrThrow(value, warn), warn, abortSignal));
     }
+    /** Creates a normalizer that throws if value is null, empty string, or empty array. */
     get required() {
         return this.chain((value, warn) => {
             if ((!value && value !== 0 && !Number.isNaN(value) && value !== false) ||
@@ -55,10 +73,12 @@ export class Normalizer {
     }
 }
 (function (Normalizer) {
+    /** Async variant of `Normalizer` for pipelines with async steps. */
     class Async {
         constructor(parseOrThrowAsync) {
             this.parseOrThrowAsync = parseOrThrowAsync;
         }
+        /** Runs the async normalizer, returning a `Normalized` result. */
         async normalize(value, abortSignal) {
             const warn = Warn.create();
             try {
@@ -80,6 +100,10 @@ export class Normalizer {
                 });
             }
         }
+        /**
+         * Runs the async normalizer, returning a `Normalized` result with value or error.
+         * Passes `undefined` as it is, suitable to normalized optional (not nullable) values.
+         */
         async normalizeIfExists(value, abortSignal) {
             const warn = Warn.create();
             try {
@@ -99,12 +123,15 @@ export class Normalizer {
                 });
             }
         }
+        /** Chains a synchronous transformation step. */
         chain(parseOrThrow) {
             return new Async(async (value, warn, abortSignal) => parseOrThrow(await this.parseOrThrowAsync(value, warn, abortSignal), warn));
         }
+        /** Chains an asynchronous transformation step. */
         chainAsync(parseOrThrowAsync) {
             return new Async(async (value, warn, abortSignal) => await parseOrThrowAsync(await this.parseOrThrowAsync(value, warn, abortSignal), warn, abortSignal));
         }
+        /** Creates an async normalizer that throws if value is null, empty string, or empty array. */
         get required() {
             return this.chain((value, warn) => {
                 if ((!value && value !== 0 && !Number.isNaN(value) && value !== false) ||
@@ -115,24 +142,30 @@ export class Normalizer {
         }
     }
     Normalizer.Async = Async;
+    /** Result container holding either a normalized value (with optional warning) or an error. */
     class Normalized {
         constructor(state) {
             this.state = state;
         }
+        /** Error message if normalization failed. */
         get errorMessage() {
             return this.state.errorMessage;
         }
+        /** Warning message if normalization succeeded with issues. */
         get warningMessage() {
             return this.state.warningMessage;
         }
+        /** The normalized value, or undefined if failed. Does not throw. */
         get valueSafe() {
             return this.state.value;
         }
+        /** The normalized value. Throws if normalization failed. */
         get value() {
             if (this.state.errorMessage)
                 throw new Error(this.errorMessage);
             return this.state.value;
         }
+        /** Allows using `Normalized` in expressions expecting the value type. */
         valueOf() {
             return this.value;
         }
@@ -143,6 +176,10 @@ export class Normalizer {
             warn?.(prependMessage(messagePrefix, this.warningMessage));
             return this.state.value;
         }
+        /**
+         * Combines multiple `Normalized` results into a single result.
+         * Aggregates all errors/warnings with optional labels.
+         */
         static combine(normalizedItems, labelByKey) {
             const normalizedItemsByKey = (Array.isArray(normalizedItems)
                 ? arrayHelpers.toDictionary(normalizedItems, (item, itemIndex) => (labelByKey?.[itemIndex] || `Item #${itemIndex + 1}`))
@@ -163,6 +200,7 @@ export class Normalizer {
     Normalizer.Normalized = Normalized;
     let Warn;
     (function (Warn) {
+        /** Creates a new warning collector. */
         function create() {
             const warn = message => {
                 warn.message =
@@ -175,7 +213,9 @@ export class Normalizer {
         }
         Warn.create = create;
     })(Warn = Normalizer.Warn || (Normalizer.Warn = {}));
+    /** Passthrough normalizer that accepts any value unchanged. */
     Normalizer.any = new Normalizer((value, warn) => value);
+    /** Normalizer that coerces to string. Returns null for empty strings. */
     Normalizer.string = new Normalizer((value, warn) => {
         if (value === null)
             return null;
@@ -183,6 +223,7 @@ export class Normalizer {
         const parsedValue = typeof value === 'string' ? value : String(value);
         return parsedValue || null;
     });
+    /** Normalizer that trims whitespace and warns if trimming occurred. */
     Normalizer.stringTrimmed = Normalizer.string.chain((value, warn) => {
         const trimmedValue = value?.trim();
         if (!trimmedValue)
@@ -191,6 +232,7 @@ export class Normalizer {
             warn('Leading or trailing whitespace is removed.');
         return trimmedValue;
     });
+    /** Normalizer that trims and lowercases strings. */
     Normalizer.stringTrimmedAndLowerCased = Normalizer.stringTrimmed.chain((value, warn) => {
         const trimmedValue = value?.trim();
         if (!trimmedValue)
@@ -199,6 +241,7 @@ export class Normalizer {
             warn('Leading or trailing whitespace is removed.');
         return trimmedValue.toLowerCase();
     });
+    /** Creates a parser that warns if string length is outside bounds. */
     function stringLimitLength(minimum, maximum) {
         return (value, warn) => {
             if (value === null)
@@ -211,10 +254,12 @@ export class Normalizer {
         };
     }
     Normalizer.stringLimitLength = stringLimitLength;
+    /** Creates a parser that validates string is a value from an enum object. */
     function stringEnum(enumObject) {
         return stringEnumValues(...Object.values(enumObject));
     }
     Normalizer.stringEnum = stringEnum;
+    /** Creates a parser that validates string is one of the allowed values. */
     function stringEnumValues(...allowedValues) {
         return (value, warn) => {
             if (value === null)
@@ -227,6 +272,7 @@ export class Normalizer {
         };
     }
     Normalizer.stringEnumValues = stringEnumValues;
+    /** Normalizer that coerces to number. Throws for NaN. */
     Normalizer.number = new Normalizer((value, warn) => {
         if (value === null)
             return null;
@@ -237,6 +283,7 @@ export class Normalizer {
             throw new Error('Invalid number value.');
         return parsedValue;
     });
+    /** Normalizer that validates number is an integer. */
     Normalizer.numberInteger = Normalizer.number.chain((value, warn) => {
         if (value === null)
             return null;
@@ -244,6 +291,7 @@ export class Normalizer {
             throw new Error('Expected an integer number.');
         return value;
     });
+    /** Creates a parser that warns if number is outside bounds. */
     function numberLimitRange(minimum, maximum) {
         return (value, warn) => {
             if (!value)
@@ -256,6 +304,7 @@ export class Normalizer {
         };
     }
     Normalizer.numberLimitRange = numberLimitRange;
+    /** Normalizer that coerces to boolean. Accepts `'true'`/`'false'` strings. */
     Normalizer.boolean = new Normalizer((value, warn) => {
         if (value === null)
             return null;
@@ -266,6 +315,7 @@ export class Normalizer {
             throw new Error('Invalid boolean value.');
         return parsedValue;
     });
+    /** Normalizer that validates value is a plain object (not array). */
     Normalizer.object = new Normalizer((value, warn) => {
         if (value === null)
             return null;
@@ -273,6 +323,7 @@ export class Normalizer {
             throw new Error('Expected an object.');
         return value;
     });
+    /** Creates a parser that throws if object is missing required keys. */
     function objectRequireKeys(...keys) {
         return (value, warn) => {
             if (!value)
@@ -284,15 +335,18 @@ export class Normalizer {
         };
     }
     Normalizer.objectRequireKeys = objectRequireKeys;
+    /** Simplifies normalization of object properties with a stronger type guarantee. */
     function objectProperties(normalizeProperties) {
         return (value, warn) => (value ? Normalized.combine(normalizeProperties(value)).getValue(warn) : null);
     }
     Normalizer.objectProperties = objectProperties;
+    /** Normalizer that wraps non-array values in an array. Returns empty array for null. */
     Normalizer.array = new Normalizer((value, warn) => {
         if (value === null)
             return [];
         return (arrayHelpers.isArray(value) ? value : [value]);
     });
+    /** Simplifies normalization of array items with a stronger type guarantee. */
     function arrayItems(itemNormalizer) {
         return (value, warn) => Normalized.combine(value.map(item => itemNormalizer.normalize(item))).getValue(warn);
     }

package/dist/types/Normalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Normalizer.js","sourceRoot":"","sources":["../../src/types/Normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAa/D,MAAM,OAAO,UAAU;IACrB,YAAqB,YAA4C;QAA5C,iBAAY,GAAZ,YAAY,CAAgC;IAAG,CAAC;IAGrE,SAAS,CAAC,KAAU;QAClB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;QACrC,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;YACtD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YAClD,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC;gBAC/B,cAAc,EAAE,IAAI,CAAC,OAAO;gBAC5B,KAAK,EAAE,WAAoB;aAC5B,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC;gBAC/B,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC;aACrC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAMD,iBAAiB,CAAI,KAAQ;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;QACrC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACpF,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC;gBAC/B,cAAc,EAAE,IAAI,CAAC,OAAO;gBAC5B,KAAK,EAAE,WAA8D;aACtE,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC;gBAC/B,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC;aACrC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAGD,KAAK,CAAW,YAAsD;QACpE,OAAO,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;IAC5F,CAAC;IAGD,UAAU,CAAW,iBAAgE;QACnF,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CACvD,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CACrE,CAAA;IACH,CAAC;IAGD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAChC,IACE,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,CAAC;gBAClE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;gBAE5C,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;YAC9B,OAAO,KAA6B,CAAA;QACtC,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,WAAiB,UAAU;IAEzB,MAAa,KAAK;QAChB,YAAqB,iBAA2C;YAA3C,sBAAiB,GAAjB,iBAAiB,CAA0B;QAAG,CAAC;QAGpE,KAAK,CAAC,SAAS,CAAC,KAAU,EAAE,WAAyB;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YAC1B,IAAI,CAAC;gBACH,IAAI,WAAW,EAAE,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrD,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;gBACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;gBAC1E,IAAI,WAAW,EAAE,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrD,OAAO,IAAI,UAAU,CAAC;oBACpB,cAAc,EAAE,IAAI,CAAC,OAAO;oBAC5B,KAAK,EAAE,WAAoB;iBAC5B,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,UAAU,CAAC;oBACpB,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;iBACzE,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAMD,KAAK,CAAC,iBAAiB,CACrB,KAAQ,EACR,WAAyB;YAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YAC1B,IAAI,CAAC;gBACH,IAAI,WAAW,EAAE,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrD,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;gBAC5G,IAAI,WAAW,EAAE,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;gBACrD,OAAO,IAAI,UAAU,CAAC;oBACpB,cAAc,EAAE,IAAI,CAAC,OAAO;oBAC5B,KAAK,EAAE,WAA8D;iBACtE,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,UAAU,CAAC;oBACpB,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;iBACzE,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAGD,KAAK,CAAW,YAA2C;YACzD,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAClD,YAAY,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAC3E,CAAA;QACH,CAAC;QAGD,UAAU,CAAW,iBAAqD;YACxE,OAAO,IAAI,KAAK,CACd,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CACjC,MAAM,iBAAiB,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CACrG,CAAA;QACH,CAAC;QAGD,IAAI,QAAQ;YACV,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAChC,IACE,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,CAAC;oBAClE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;oBAE5C,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;gBAC9B,OAAO,KAA6B,CAAA;YACtC,CAAC,CAAC,CAAA;QACJ,CAAC;KACF;IAxEY,gBAAK,QAwEjB,CAAA;IAGD,MAAa,UAAU;QACrB,YACmB,KAUZ;YAVY,UAAK,GAAL,KAAK,CAUjB;QACJ,CAAC;QAGJ,IAAI,YAAY;YACd,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAA;QAChC,CAAC;QAGD,IAAI,cAAc;YAChB,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAA;QAClC,CAAC;QAGD,IAAI,SAAS;YACX,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAA;QACzB,CAAC;QAGD,IAAI,KAAK;YACP,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,KAAM,CAAA;QAC1B,CAAC;QAGD,OAAO;YACL,OAAO,IAAI,CAAC,KAAK,CAAA;QACnB,CAAC;QASD,QAAQ,CACN,mBAAkC,EAClC,IAAI,GAAG,OAAO,mBAAmB,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS;YAElF,MAAM,aAAa,GAAG,OAAO,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAA;YAC/F,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;YACpG,IAAI,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAA;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,KAAM,CAAA;QAC1B,CAAC;QAMD,MAAM,CAAC,OAAO,CACZ,eAAkB,EAClB,UAAyD;YAEzD,MAAM,oBAAoB,GAAG,CAC3B,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBAC5B,CAAC,CAAC,YAAY,CAAC,YAAY,CACvB,eAAe,EACf,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,SAA2B,CAAC,IAAI,SAAS,SAAS,GAAG,CAAC,EAAE,CAAW,CACvG;gBACH,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CACjC,CAAA;YAEhD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAA;YACjE,IAAI,YAAY;gBAAE,OAAO,IAAI,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,CAAA;YAEzD,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;YACrE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;gBAC1C,CAAC,CAAE,eAA8C,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/G,CAAC,CAAC,aAAa,CAAC,YAAY,CACxB,aAAa,CAAC,GAAG,CAAC,eAA8D,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAC/F,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAClD,CACF,CAAA;YAEL,OAAO,IAAI,UAAU,CAAC;gBACpB,cAAc;gBACd,KAAK,EAAE,KAAY;aACpB,CAAC,CAAA;QACJ,CAAC;KACF;IA5FY,qBAAU,aA4FtB,CAAA;IAyCD,IAAiB,IAAI,CAcpB;IAdD,WAAiB,IAAI;QAEnB,SAAgB,MAAM;YACpB,MAAM,IAAI,GAA2C,OAAO,CAAC,EAAE;gBAC7D,IAAI,CAAC,OAAO;oBACV,YAAY;yBACT,cAAc,CACb,YAAY,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAClG;yBACA,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;YAC9B,CAAC,CAAA;YACD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QAXe,WAAM,SAWrB,CAAA;IACH,CAAC,EAdgB,IAAI,GAAJ,eAAI,KAAJ,eAAI,QAcpB;IAGY,cAAG,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;IAG5C,iBAAM,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACvD,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrE,OAAO,WAAW,IAAI,IAAI,CAAA;IAC5B,CAAC,CAAC,CAAA;IAGW,wBAAa,GAAG,WAAA,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxD,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAA;QAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,YAAY,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,4CAA4C,CAAC,CAAA;QAC9G,OAAO,YAAY,CAAA;IACrB,CAAC,CAAC,CAAA;IAGW,qCAA0B,GAAG,WAAA,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5E,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAA;QAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,YAAY,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,4CAA4C,CAAC,CAAA;QAC9G,OAAO,YAAY,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC,CAAC,CAAA;IAGF,SAAgB,iBAAiB,CAAC,OAAe,EAAE,OAAe;QAChE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;gBAAE,IAAI,CAAC,YAAY,OAAO,cAAc,CAAC,CAAA;YACnE,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;gBAAE,IAAI,CAAC,WAAW,OAAO,cAAc,CAAC,CAAA;YAClE,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;IACH,CAAC;IAPe,4BAAiB,oBAOhC,CAAA;IAGD,SAAgB,UAAU,CAAmB,UAAyC;QAIpF,OAAO,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;IACvD,CAAC;IALe,qBAAU,aAKzB,CAAA;IAGD,SAAgB,gBAAgB,CAC9B,GAAG,aAAgB;QAEnB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC/B,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,aAAa,CAAC,MAAM,GAAG,CAAC;oBACtB,CAAC,CAAC,yCAAyC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC/G,CAAC,CAAC,gBAAgB,CACrB,CAAA;YACH,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;IACH,CAAC;IAbe,2BAAgB,mBAa/B,CAAA;IAGY,iBAAM,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACzD,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrE,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACvE,OAAO,WAAW,CAAA;IACpB,CAAC,CAAC,CAAA;IAGW,wBAAa,GAAG,WAAA,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAC5E,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;IAGF,SAAgB,gBAAgB,CAAC,OAAe,EAAE,OAAe;QAC/D,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAA;YACxB,IAAI,KAAK,GAAG,OAAO;gBAAE,IAAI,CAAC,YAAY,OAAO,GAAG,CAAC,CAAA;YACjD,IAAI,KAAK,GAAG,OAAO;gBAAE,IAAI,CAAC,WAAW,OAAO,GAAG,CAAC,CAAA;YAChD,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;IACH,CAAC;IAPe,2BAAgB,mBAO/B,CAAA;IAGY,kBAAO,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACpD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,qBAAqB,CAAC,CAAA;QAC3D,MAAM,WAAW,GACf,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACtG,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;QACxE,OAAO,WAAW,CAAA;IACpB,CAAC,CAAC,CAAA;IAGW,iBAAM,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC/B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAC9G,OAAO,KAA4B,CAAA;IACrC,CAAC,CAAC,CAAA;IAGF,SAAgB,iBAAiB,CAC/B,GAAG,IAAuB;QAE1B,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAA;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;YAChE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClH,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;IACH,CAAC;IAVe,4BAAiB,oBAUhC,CAAA;IAGD,SAAgB,gBAAgB,CAC9B,mBAAsD;QAEtD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACpH,CAAC;IAJe,2BAAgB,mBAI/B,CAAA;IAGY,gBAAK,GAAG,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAClD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,CAAA;QAC7B,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAU,CAAA;IACjE,CAAC,CAAC,CAAA;IAGF,SAAgB,UAAU,CAAI,cAA6B;QACzD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9G,CAAC;IAFe,qBAAU,aAEzB,CAAA;AACH,CAAC,EAxWgB,UAAU,KAAV,UAAU,QAwW1B"}
+{"version":3,"file":"Normalizer.js","sourceRoot":"","sources":["../../src/types/Normalizer.ts"],"names":[],"mappings":"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"}

package/dist/types/Phone.d.ts

@@ -1,5 +1,6 @@
 import { Json } from './Json';
 import { Normalizer } from './Normalizer';
+/** A phone number string with optional leading `+`. */
 export type Phone = string;
 export declare namespace Phone {
     const normalizer: Normalizer<string | null>;

package/dist/types/Phone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Phone.d.ts","sourceRoot":"","sources":["../../src/types/Phone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,MAAM,KAAK,GAAG,MAAM,CAAA;AAE1B,yBAAiB,KAAK,CAAC;IACd,MAAM,UAAU,2BAMrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}
+{"version":3,"file":"Phone.d.ts","sourceRoot":"","sources":["../../src/types/Phone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,uDAAuD;AACvD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAA;AAE1B,yBAAiB,KAAK,CAAC;IACd,MAAM,UAAU,2BAMrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}

package/dist/types/Slug.d.ts

@@ -1,5 +1,6 @@
 import { Json } from './Json';
 import { Normalizer } from './Normalizer';
+/** A URL-friendly string consisting of lowercase letters, numbers, and dash (-) characters. */
 export type Slug = string;
 export declare namespace Slug {
     const normalizer: Normalizer<string | null>;

package/dist/types/Slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Slug.d.ts","sourceRoot":"","sources":["../../src/types/Slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AAEzB,yBAAiB,IAAI,CAAC;IACb,MAAM,UAAU,2BAMrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}
+{"version":3,"file":"Slug.d.ts","sourceRoot":"","sources":["../../src/types/Slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,+FAA+F;AAC/F,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AAEzB,yBAAiB,IAAI,CAAC;IACb,MAAM,UAAU,2BAMrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}

package/dist/types/TimeOnly.d.ts

@@ -1,5 +1,6 @@
 import { Json } from './Json';
 import { Normalizer } from './Normalizer';
+/** ISO formatted time string: `HH:mm:ss.sss` */
 export type TimeOnly = string;
 export declare namespace TimeOnly {
     const normalizer: Normalizer<string | null>;

package/dist/types/TimeOnly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimeOnly.d.ts","sourceRoot":"","sources":["../../src/types/TimeOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,yBAAiB,QAAQ,CAAC;IACjB,MAAM,UAAU,2BAiBrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}
+{"version":3,"file":"TimeOnly.d.ts","sourceRoot":"","sources":["../../src/types/TimeOnly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,yBAAiB,QAAQ,CAAC;IACjB,MAAM,UAAU,2BAiBrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}

package/dist/types/Url.d.ts

@@ -1,5 +1,6 @@
 import { Json } from './Json';
 import { Normalizer } from './Normalizer';
+/** A URL string (href). */
 export type Url = string;
 export declare namespace Url {
     const normalizer: Normalizer<string | null>;

package/dist/types/Url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Url.d.ts","sourceRoot":"","sources":["../../src/types/Url.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,yBAAiB,GAAG,CAAC;IACZ,MAAM,UAAU,2BAOrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAI7B,CAAA;CACF"}
+{"version":3,"file":"Url.d.ts","sourceRoot":"","sources":["../../src/types/Url.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,2BAA2B;AAC3B,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,yBAAiB,GAAG,CAAC;IACZ,MAAM,UAAU,2BAOrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAI7B,CAAA;CACF"}

package/dist/types/Uuid.d.ts

@@ -1,5 +1,6 @@
 import { Json } from './Json';
 import { Normalizer } from './Normalizer';
+/** A UUID string. */
 export type Uuid = string;
 export declare namespace Uuid {
     const normalizer: Normalizer<string | null>;

package/dist/types/Uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Uuid.d.ts","sourceRoot":"","sources":["../../src/types/Uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AAEzB,yBAAiB,IAAI,CAAC;IACb,MAAM,UAAU,2BAIrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}
+{"version":3,"file":"Uuid.d.ts","sourceRoot":"","sources":["../../src/types/Uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,qBAAqB;AACrB,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AAEzB,yBAAiB,IAAI,CAAC;IACb,MAAM,UAAU,2BAIrB,CAAA;IAEK,MAAM,UAAU,EAAE,IAAI,CAAC,MAG7B,CAAA;CACF"}