Add Parse.defaulted

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@endeavorance/parsec",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "author": "Endeavorance",
   "type": "module",
   "module": "dist/index.js",

src/index.ts

@@ -223,6 +223,19 @@ export const Parse = {
     };
   },
 
+  defaulted<T>(
+    parser: (val: unknown) => T,
+    defaultVal: T,
+  ): (val: unknown) => T {
+    return (val: unknown) => {
+      if (val === undefined || val === null) {
+        return defaultVal;
+      }
+
+      return parser(val);
+    };
+  },
+
   oneOf<T extends Parser<unknown>[]>(
     parsers: T,
     shapeName = "Union",

src/test/parse.test.ts

@@ -176,6 +176,14 @@ describe(Parse.nullable, () => {
   });
 });
 
+describe(Parse.defaulted, () => {
+  test("Parses uses a default value for undefined params", () => {
+    expect(Parse.defaulted(Parse.string, "default!")(undefined)).toBe(
+      "default!",
+    );
+  });
+});
+
 describe(Parse.nan, () => {
   test("Parses NaN", () => {
     expect(Parse.nan(Number.NaN)).toBe(Number.NaN);