ts-fortress 2.6.2 → 2.7.0

package/dist/utils/create-cast-fn.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-cast-fn.d.mts","sourceRoot":"","sources":["../../src/utils/create-cast-fn.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AASxC,eAAO,MAAM,YAAY,GACtB,CAAC,EAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MACjC,GAAG,OAAO,KAAG,CAMb,CAAC"}
+{"version":3,"file":"create-cast-fn.d.mts","sourceRoot":"","sources":["../../src/utils/create-cast-fn.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,eAAO,MAAM,YAAY,GACtB,CAAC,EAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MACjC,GAAG,OAAO,KAAG,CAMb,CAAC"}

package/dist/utils/create-cast-fn.mjs

@@ -1,11 +1,10 @@
 import { Result } from 'ts-data-forge';
 import { validationErrorsToMessages } from './validation-error.mjs';
 
-const validationResultToString = (result) => `\n${validationErrorsToMessages(result).join(',\n')}`;
 const createCastFn = (validate) => (a) => {
     const res = validate(a);
     if (Result.isErr(res)) {
-        throw new Error(validationResultToString(res.value));
+        throw new Error(validationErrorsToMessages(res.value).join('\n'));
     }
     return res.value;
 };

package/dist/utils/create-cast-fn.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-cast-fn.mjs","sources":["../../src/utils/create-cast-fn.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAOA,MAAM,wBAAwB,GAAG,CAAC,MAAkC,KAClE,CAAA,EAAA,EAAK,0BAA0B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;AAEhD,MAAM,YAAY,GACvB,CAAK,QAA6B,KAClC,CAAC,CAAU,KAAO;AAChB,IAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC;AACvB,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QACrB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtD;IACA,OAAO,GAAG,CAAC,KAAK;AAClB;;;;"}
+{"version":3,"file":"create-cast-fn.mjs","sources":["../../src/utils/create-cast-fn.mts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIO,MAAM,YAAY,GACvB,CAAK,QAA6B,KAClC,CAAC,CAAU,KAAO;AAChB,IAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC;AACvB,IAAA,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;AACrB,QAAA,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE;IACA,OAAO,GAAG,CAAC,KAAK;AAClB;;;;"}

package/dist/utils/validation-error.d.mts

@@ -19,12 +19,12 @@ export type ValidationErrorWithMessage = MergeIntersection<StrictOmit<Validation
 /**
  * Converts a validation error to a human-readable string message
  */
-export declare const validationErrorToMessage: (error: ValidationError) => string;
+export declare const validationErrorToMessage: (error: ValidationError, maxLengthToPrintActualValue?: number) => string;
 /**
  * Converts an array of validation errors to an array of string messages
  * (for backward compatibility)
  */
-export declare const validationErrorsToMessages: (errors: readonly ValidationError[]) => readonly string[];
+export declare const validationErrorsToMessages: (errors: readonly ValidationError[], maxLengthToPrintActualValue?: number) => readonly string[];
 /**
  * Prepends a path segment to all validation errors
  */

package/dist/utils/validation-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-error.d.mts","sourceRoot":"","sources":["../../src/utils/validation-error.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,iFAAiF;IACjF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,CACxD,UAAU,CAAC,eAAe,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CACvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,eAAe,KAAG,MASjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,eAAe,EAAE,KACjC,SAAS,MAAM,EAA0C,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,SAAS,eAAe,EAAE,EAClC,aAAa,MAAM,KAClB,SAAS,eAAe,EAItB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,8BAA8B,GACzC,QAAQ,SAAS,eAAe,EAAE,EAClC,OAAO,MAAM,KACZ,SAAS,eAAe,EAC8B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAAI,0CAI5C,QAAQ,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,KAAG,eAMH,CAAC"}
+{"version":3,"file":"validation-error.d.mts","sourceRoot":"","sources":["../../src/utils/validation-error.mts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,iFAAiF;IACjF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,CACxD,UAAU,CAAC,eAAe,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CACvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,eAAe,EACtB,8BAA6B,MAAW,KACvC,MAiBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,eAAe,EAAE,EAClC,8BAA6B,MAAW,KACvC,SAAS,MAAM,EAC2D,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,SAAS,eAAe,EAAE,EAClC,aAAa,MAAM,KAClB,SAAS,eAAe,EAItB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,8BAA8B,GACzC,QAAQ,SAAS,eAAe,EAAE,EAClC,OAAO,MAAM,KACZ,SAAS,eAAe,EAC8B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAAI,0CAI5C,QAAQ,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,KAAG,eAMH,CAAC"}

package/dist/utils/validation-error.mjs

@@ -1,19 +1,26 @@
+import { isString, pipe, unknownToString } from 'ts-data-forge';
+
 /**
  * Converts a validation error to a human-readable string message
  */
-const validationErrorToMessage = (error) => {
+const validationErrorToMessage = (error, maxLengthToPrintActualValue = 20) => {
     const pathStr = error.path.length > 0 ? ` at ${error.path.join('.')}` : '';
     const actualTypeStr = typeof error.actualValue;
     if (error.message !== undefined) {
         return `${error.message}${pathStr}`;
     }
-    return `Expected ${error.expectedType}${pathStr}, got ${actualTypeStr}`;
+    const actualValueStr = isString(error.actualValue)
+        ? error.actualValue.length <= maxLengthToPrintActualValue
+            ? ` "${error.actualValue}"`
+            : ''
+        : pipe(unknownToString(error.actualValue)).map((s) => s.length <= maxLengthToPrintActualValue ? ` \`${s}\`` : '').value;
+    return `Expected <${error.expectedType}>${pathStr}, got <${actualTypeStr}> type value${actualValueStr}.`;
 };
 /**
  * Converts an array of validation errors to an array of string messages
  * (for backward compatibility)
  */
-const validationErrorsToMessages = (errors) => errors.map(validationErrorToMessage);
+const validationErrorsToMessages = (errors, maxLengthToPrintActualValue = 20) => errors.map((e) => validationErrorToMessage(e, maxLengthToPrintActualValue));
 /**
  * Prepends a path segment to all validation errors
  */

package/dist/utils/validation-error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation-error.mjs","sources":["../../src/utils/validation-error.mts"],"sourcesContent":[null],"names":[],"mappings":"AAoBA;;AAEG;AACI,MAAM,wBAAwB,GAAG,CAAC,KAAsB,KAAY;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAA,IAAA,EAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA,CAAE,GAAG,EAAE;AAC1E,IAAA,MAAM,aAAa,GAAG,OAAO,KAAK,CAAC,WAAW;AAE9C,IAAA,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE;AAC/B,QAAA,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA,EAAG,OAAO,EAAE;IACrC;IAEA,OAAO,CAAA,SAAA,EAAY,KAAK,CAAC,YAAY,GAAG,OAAO,CAAA,MAAA,EAAS,aAAa,CAAA,CAAE;AACzE;AAEA;;;AAGG;AACI,MAAM,0BAA0B,GAAG,CACxC,MAAkC,KACZ,MAAM,CAAC,GAAG,CAAC,wBAAwB;AAE3D;;AAEG;MACU,6BAA6B,GAAG,CAC3C,MAAkC,EAClC,WAAmB,KAEnB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;AACrB,IAAA,GAAG,KAAK;IACR,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;AACnC,CAAA,CAAC;AAEJ;;AAEG;MACU,8BAA8B,GAAG,CAC5C,MAAkC,EAClC,KAAa,KAEb,6BAA6B,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE;AAExD;;AAEG;AACI,MAAM,8BAA8B,GAAG,CAAC,EAC7C,WAAW,EACX,YAAY,EACZ,QAAQ,GAKR,MAAuB;AACvB,IAAA,IAAI,EAAE,EAAE;IACR,WAAW;IACX,YAAY;IACZ,QAAQ;AACR,IAAA,OAAO,EAAE,SAAS;AACnB,CAAA;;;;"}
+{"version":3,"file":"validation-error.mjs","sources":["../../src/utils/validation-error.mts"],"sourcesContent":[null],"names":[],"mappings":";;AAsBA;;AAEG;AACI,MAAM,wBAAwB,GAAG,CACtC,KAAsB,EACtB,2BAAA,GAAsC,EAAE,KAC9B;IACV,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAA,IAAA,EAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA,CAAE,GAAG,EAAE;AAC1E,IAAA,MAAM,aAAa,GAAG,OAAO,KAAK,CAAC,WAAW;AAE9C,IAAA,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE;AAC/B,QAAA,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA,EAAG,OAAO,EAAE;IACrC;AAEA,IAAA,MAAM,cAAc,GAAW,QAAQ,CAAC,KAAK,CAAC,WAAW;AACvD,UAAE,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI;AAC5B,cAAE,CAAA,EAAA,EAAK,KAAK,CAAC,WAAW,CAAA,CAAA;AACxB,cAAE;AACJ,UAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAC7C,CAAC,CAAC,MAAM,IAAI,2BAA2B,GAAG,CAAA,GAAA,EAAM,CAAC,CAAA,EAAA,CAAI,GAAG,EAAE,CAC3D,CAAC,KAAK;IAEX,OAAO,CAAA,UAAA,EAAa,KAAK,CAAC,YAAY,CAAA,CAAA,EAAI,OAAO,CAAA,OAAA,EAAU,aAAa,CAAA,YAAA,EAAe,cAAc,CAAA,CAAA,CAAG;AAC1G;AAEA;;;AAGG;AACI,MAAM,0BAA0B,GAAG,CACxC,MAAkC,EAClC,2BAAA,GAAsC,EAAE,KAExC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,wBAAwB,CAAC,CAAC,EAAE,2BAA2B,CAAC;AAE5E;;AAEG;MACU,6BAA6B,GAAG,CAC3C,MAAkC,EAClC,WAAmB,KAEnB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;AACrB,IAAA,GAAG,KAAK;IACR,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;AACnC,CAAA,CAAC;AAEJ;;AAEG;MACU,8BAA8B,GAAG,CAC5C,MAAkC,EAClC,KAAa,KAEb,6BAA6B,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE;AAExD;;AAEG;AACI,MAAM,8BAA8B,GAAG,CAAC,EAC7C,WAAW,EACX,YAAY,EACZ,QAAQ,GAKR,MAAuB;AACvB,IAAA,IAAI,EAAE,EAAE;IACR,WAAW;IACX,YAAY;IACZ,QAAQ;AACR,IAAA,OAAO,EAAE,SAAS;AACnB,CAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-fortress",
-  "version": "2.6.2",
+  "version": "2.7.0",
   "private": false,
   "keywords": [
     "typescript"
@@ -94,7 +94,7 @@
     "ts-repo-utils": "^7.0.4",
     "tslib": "^2.8.1",
     "tsx": "^4.20.4",
-    "typedoc": "^0.28.10",
+    "typedoc": "^0.28.11",
     "typedoc-plugin-markdown": "^4.8.1",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.41.0",

package/src/array/array-of-length.test.mts

@@ -146,8 +146,8 @@ describe('arrayOfLength', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at 1, got string',
-          'Expected number at 2, got string',
+          'Expected <number> at 1, got <string> type value "1".',
+          'Expected <number> at 2, got <string> type value "".',
         ]);
       }
     });

package/src/array/array.test.mts

@@ -101,11 +101,9 @@ describe('array', () => {
 
         // Test that we can convert to legacy string format for backward compatibility
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at 0, got string',
-          'Expected number at 1, got string',
+          'Expected <number> at 0, got <string> type value "1".',
+          'Expected <number> at 1, got <string> type value "".',
         ]);
-      } else {
-        throw new Error('Expected validation to fail');
       }
     });
 

package/src/array/non-empty-array.test.mts

@@ -146,8 +146,8 @@ describe('nonEmptyArray', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at 0, got string',
-          'Expected number at 1, got string',
+          'Expected <number> at 0, got <string> type value "1".',
+          'Expected <number> at 1, got <string> type value "".',
         ]);
       }
     });

package/src/array/tuple.test.mts

@@ -153,8 +153,8 @@ describe('tuple', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at 0.x, got string',
-          'Expected number at 0.y, got string',
+          'Expected <number> at 0.x, got <string> type value "str".',
+          'Expected <number> at 0.y, got <string> type value "str".',
         ]);
       }
     });

package/src/branded/number/finite-number.test.mts

@@ -115,7 +115,7 @@ describe('finiteNumber', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number, got string',
+          'Expected <number>, got <string> type value "not a number".',
         ]);
       }
     });

package/src/branded/number/int.test.mts

@@ -98,7 +98,7 @@ describe('int', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number, got string',
+          'Expected <number>, got <string> type value "not a number".',
         ]);
       }
     });

package/src/branded/number/positive-int.test.mts

@@ -125,7 +125,7 @@ describe('positiveInt', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number, got string',
+          'Expected <number>, got <string> type value "not a number".',
         ]);
       }
     });

package/src/branded/number/uint.test.mts

@@ -120,7 +120,7 @@ describe('uint', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number, got string',
+          'Expected <number>, got <string> type value "not a number".',
         ]);
       }
     });

package/src/branded/simple-branded-number.test.mts

@@ -69,7 +69,7 @@ describe('simpleBrandedNumber', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected number, got string',
+            'Expected <number>, got <string> type value "not a number".',
           ]);
         }
       });
@@ -142,7 +142,7 @@ describe('simpleBrandedNumber', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected number, got string',
+            'Expected <number>, got <string> type value "invalid".',
           ]);
         }
       });

package/src/branded/simple-branded-string.test.mts

@@ -70,7 +70,7 @@ describe('simpleBrandedString', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected string, got number',
+            'Expected <string>, got <number> type value `42`.',
           ]);
         }
       });
@@ -143,7 +143,7 @@ describe('simpleBrandedString', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected string, got object',
+            'Expected <string>, got <object> type value `null`.',
           ]);
         }
       });

package/src/compose/intersection.test.mts

@@ -251,9 +251,9 @@ describe('intersection', () => {
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
             'The type of value is expected to match all types of { number, number }',
-            'Expected number, got string',
+            'Expected <number>, got <string> type value "aaa".',
             'The type of value is expected to match all types of { number, number }',
-            'Expected number, got string',
+            'Expected <number>, got <string> type value "aaa".',
           ]);
         }
       });

package/src/enum/enum.test.mts

@@ -72,8 +72,6 @@ describe('enumType', () => {
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
           'The value is expected to be one of the elements contained in { 3, 2, a }',
         ]);
-      } else {
-        throw new Error('Expected validation to fail');
       }
     });
 

package/src/enum/uint-range.test.mts

@@ -81,8 +81,6 @@ describe('uintRange', () => {
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
           'The value is expected to be an integer between 1 and 12',
         ]);
-      } else {
-        throw new Error('Expected validation to fail');
       }
     });
   });

package/src/primitives/bigint.test.mts

@@ -64,7 +64,7 @@ describe('bigint', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected bigint, got number',
+          'Expected <bigint>, got <number> type value `123`.',
         ]);
       }
     });
@@ -199,7 +199,7 @@ describe('bigintLiteral', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected bigintLiteral(42), got bigint',
+          'Expected <bigintLiteral(42)>, got <bigint> type value `99`.',
         ]);
       }
     });
@@ -220,7 +220,7 @@ describe('bigintLiteral', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected bigintLiteral(42), got string',
+          'Expected <bigintLiteral(42)>, got <string> type value "not a bigint".',
         ]);
       }
     });

package/src/primitives/boolean.test.mts

@@ -64,7 +64,7 @@ describe('boolean', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected boolean, got string',
+          'Expected <boolean>, got <string> type value "not a boolean".',
         ]);
       }
     });
@@ -202,7 +202,7 @@ describe('booleanLiteral', () => {
           ]);
 
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected booleanLiteral(true), got boolean',
+            'Expected <booleanLiteral(true)>, got <boolean> type value `false`.',
           ]);
         }
       });
@@ -223,7 +223,7 @@ describe('booleanLiteral', () => {
           ]);
 
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected booleanLiteral(true), got string',
+            'Expected <booleanLiteral(true)>, got <string> type value "not a boolean".',
           ]);
         }
       });
@@ -318,7 +318,7 @@ describe('booleanLiteral', () => {
           ]);
 
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected booleanLiteral(false), got boolean',
+            'Expected <booleanLiteral(false)>, got <boolean> type value `true`.',
           ]);
         }
       });

package/src/primitives/null.test.mts

@@ -68,7 +68,7 @@ describe('nullType', () => {
       const value: unknown = undefined;
       expect(() => {
         nullType.assertIs(value);
-      }).toThrow('Expected null, got undefined');
+      }).toThrow('Expected <null>, got <undefined> type value `undefined`.');
     });
   });
 
@@ -82,7 +82,7 @@ describe('nullType', () => {
     test('non-null throws error', () => {
       const value: unknown = undefined;
       expect(() => nullType.cast(value)).toThrow(
-        'Expected null, got undefined',
+        'Expected <null>, got <undefined> type value `undefined`.',
       );
     });
 
@@ -91,7 +91,7 @@ describe('nullType', () => {
 
       for (const value of values) {
         expect(() => nullType.cast(value)).toThrow(
-          /Expected null, got (number|string|boolean|undefined)/u,
+          /Expected <null>, got <(number|string|boolean|undefined)> type value/u,
         );
       }
     });

package/src/primitives/number.test.mts

@@ -88,7 +88,7 @@ describe('number', () => {
       const value: unknown = '42';
       expect(() => {
         assertIs(value);
-      }).toThrow(/Expected number/u);
+      }).toThrow(/Expected <number>/u);
     });
   });
 
@@ -101,14 +101,16 @@ describe('number', () => {
 
     test('invalid value throws error', () => {
       const value: unknown = 'not a number';
-      expect(() => num.cast(value)).toThrow('Expected number, got string');
+      expect(() => num.cast(value)).toThrow(
+        'Expected <number>, got <string> type value "not a number".',
+      );
     });
 
     test('throws error with type mismatch', () => {
       const numWithDefault = number(100);
       const value: unknown = 'not a number';
       expect(() => numWithDefault.cast(value)).toThrow(
-        'Expected number, got string',
+        'Expected <number>, got <string> type value "not a number".',
       );
     });
   });

package/src/primitives/string.test.mts

@@ -91,7 +91,7 @@ describe('string', () => {
       const value: unknown = 42;
       expect(() => {
         assertIs(value);
-      }).toThrow(/Expected string/u);
+      }).toThrow(/Expected <string>/u);
     });
   });
 
@@ -104,14 +104,16 @@ describe('string', () => {
 
     test('invalid value throws error', () => {
       const value: unknown = 42;
-      expect(() => str.cast(value)).toThrow('Expected string, got number');
+      expect(() => str.cast(value)).toThrow(
+        'Expected <string>, got <number> type value `42`.',
+      );
     });
 
     test('throws error with type mismatch', () => {
       const strWithDefault = string('default');
       const value: unknown = 42;
       expect(() => strWithDefault.cast(value)).toThrow(
-        'Expected string, got number',
+        'Expected <string>, got <number> type value `42`.',
       );
     });
   });
@@ -332,7 +334,7 @@ describe('stringLiteral', () => {
     test('invalid value throws error', () => {
       const value: unknown = 'world';
       expect(() => hello.cast(value)).toThrow(
-        'Expected stringLiteral("hello"), got string',
+        'Expected <stringLiteral("hello")>, got <string> type value "world".',
       );
     });
   });

package/src/primitives/symbol.test.mts

@@ -66,7 +66,7 @@ describe('symbol', () => {
         ]);
 
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected symbol, got string',
+          'Expected <symbol>, got <string> type value "not a symbol".',
         ]);
       }
     });

package/src/primitives/undefined.test.mts

@@ -77,7 +77,7 @@ describe('undefinedType', () => {
       const value: unknown = null;
       expect(() => {
         undefinedType.assertIs(value);
-      }).toThrow(`Expected undefined, got ${typeof value}`);
+      }).toThrow('Expected <undefined>, got <object> type value `null`.');
     });
   });
 
@@ -92,7 +92,7 @@ describe('undefinedType', () => {
       const value: unknown = null;
       expect(() => {
         undefinedType.cast(value);
-      }).toThrow('Expected undefined, got object');
+      }).toThrow('Expected <undefined>, got <object> type value `null`.');
     });
 
     test('any non-undefined value throws error', () => {
@@ -101,7 +101,7 @@ describe('undefinedType', () => {
       for (const value of values) {
         expect(() => {
           undefinedType.cast(value);
-        }).toThrow(`Expected undefined, got ${typeof value}`);
+        }).toThrow(/^Expected <undefined>, got <.*> type value .+\.$/u);
       }
     });
   });

package/src/record/key-value-record.test.mts

@@ -130,9 +130,9 @@ describe('keyValueRecord', () => {
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
           'The value of the record is expected to be <number>',
-          'Expected number at month, got string',
+          'Expected <number> at month, got <string> type value "ab".',
           'The value of the record is expected to be <number>',
-          'Expected number at date, got string',
+          'Expected <number> at date, got <string> type value "cd".',
         ]);
       }
     });

package/src/record/omit.test.mts

@@ -138,7 +138,7 @@ describe('omit', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at month, got string',
+          'Expected <number> at month, got <string> type value "ab".',
         ]);
       }
     });

package/src/record/partial.test.mts

@@ -186,8 +186,8 @@ describe('partial', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected number at month, got string',
-            'Expected number at date, got string',
+            'Expected <number> at month, got <string> type value "ab".',
+            'Expected <number> at date, got <string> type value "cd".',
           ]);
         }
       });
@@ -212,7 +212,7 @@ describe('partial', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected number at month, got string',
+            'Expected <number> at month, got <string> type value "ab".',
           ]);
         }
       });
@@ -385,8 +385,8 @@ describe('partial', () => {
             },
           ]);
           expect(validationErrorsToMessages(result.value)).toStrictEqual([
-            'Expected number at month, got string',
-            'Expected number at date, got string',
+            'Expected <number> at month, got <string> type value "ab".',
+            'Expected <number> at date, got <string> type value "cd".',
           ]);
         }
       });

package/src/record/pick.test.mts

@@ -138,7 +138,7 @@ describe('pick', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at month, got string',
+          'Expected <number> at month, got <string> type value "ab".',
         ]);
       }
     });

package/src/record/record.test.mts

@@ -106,8 +106,8 @@ describe('record', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at month, got string',
-          'Expected number at date, got string',
+          'Expected <number> at month, got <string> type value "ab".',
+          'Expected <number> at date, got <string> type value "cd".',
         ]);
       }
     });
@@ -319,8 +319,8 @@ describe('partial record', () => {
           },
         ]);
         expect(validationErrorsToMessages(result.value)).toStrictEqual([
-          'Expected number at month, got string',
-          'Expected number at date, got string',
+          'Expected <number> at month, got <string> type value "ab".',
+          'Expected <number> at date, got <string> type value "cd".',
         ]);
       }
     });

package/src/utils/create-cast-fn.mts

@@ -1,19 +1,13 @@
 import { Result } from 'ts-data-forge';
 import { type Type } from '../type.mjs';
-import {
-  validationErrorsToMessages,
-  type ValidationError,
-} from './validation-error.mjs';
-
-const validationResultToString = (result: readonly ValidationError[]): string =>
-  `\n${validationErrorsToMessages(result).join(',\n')}`;
+import { validationErrorsToMessages } from './validation-error.mjs';
 
 export const createCastFn =
   <T,>(validate: Type<T>['validate']) =>
   (a: unknown): T => {
     const res = validate(a);
     if (Result.isErr(res)) {
-      throw new Error(validationResultToString(res.value));
+      throw new Error(validationErrorsToMessages(res.value).join('\n'));
     }
     return res.value;
   };

package/src/utils/validation-error.mts

@@ -1,3 +1,5 @@
+import { isString, pipe, unknownToString } from 'ts-data-forge';
+
 /**
  * Represents a validation error with structured information
  */
@@ -21,7 +23,10 @@ export type ValidationErrorWithMessage = MergeIntersection<
 /**
  * Converts a validation error to a human-readable string message
  */
-export const validationErrorToMessage = (error: ValidationError): string => {
+export const validationErrorToMessage = (
+  error: ValidationError,
+  maxLengthToPrintActualValue: number = 20,
+): string => {
   const pathStr = error.path.length > 0 ? ` at ${error.path.join('.')}` : '';
   const actualTypeStr = typeof error.actualValue;
 
@@ -29,7 +34,15 @@ export const validationErrorToMessage = (error: ValidationError): string => {
     return `${error.message}${pathStr}`;
   }
 
-  return `Expected ${error.expectedType}${pathStr}, got ${actualTypeStr}`;
+  const actualValueStr: string = isString(error.actualValue)
+    ? error.actualValue.length <= maxLengthToPrintActualValue
+      ? ` "${error.actualValue}"`
+      : ''
+    : pipe(unknownToString(error.actualValue)).map((s) =>
+        s.length <= maxLengthToPrintActualValue ? ` \`${s}\`` : '',
+      ).value;
+
+  return `Expected <${error.expectedType}>${pathStr}, got <${actualTypeStr}> type value${actualValueStr}.`;
 };
 
 /**
@@ -38,7 +51,9 @@ export const validationErrorToMessage = (error: ValidationError): string => {
  */
 export const validationErrorsToMessages = (
   errors: readonly ValidationError[],
-): readonly string[] => errors.map(validationErrorToMessage);
+  maxLengthToPrintActualValue: number = 20,
+): readonly string[] =>
+  errors.map((e) => validationErrorToMessage(e, maxLengthToPrintActualValue));
 
 /**
  * Prepends a path segment to all validation errors

package/src/utils/validation-error.test.mts

@@ -144,9 +144,9 @@ describe('validation-error', () => {
       ];
 
       expect(validationErrorsToMessages(errors)).toStrictEqual([
-        'Expected string at user.name, got number',
-        'Expected number at items.0, got string',
-        'Expected boolean, got object',
+        'Expected <string> at user.name, got <number> type value `123`.',
+        'Expected <number> at items.0, got <string> type value "invalid".',
+        'Expected <boolean>, got <object> type value `null`.',
       ]);
     });