functionalscript 0.12.3 → 0.12.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "functionalscript",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "type": "module",
   "files": [
     "**/*.js",

package/types/rtti/module.f.d.ts

@@ -62,4 +62,6 @@ export declare const record: MakeType1<'record'>;
 export type Or<T extends readonly Type[]> = () => readonly ['or', ...T];
 /** Constructs a schema that validates a value matching any of the given schemas. */
 export declare const or: <T extends readonly Type[]>(...types: T) => Or<T>;
+/** Constructs a schema that validates a value matching `T` or `undefined`. */
+export declare const option: <T extends Type>(t: T) => Or<readonly [T, undefined]>;
 export {};

package/types/rtti/module.f.js

@@ -21,3 +21,5 @@ export const array = type1('array');
 export const record = type1('record');
 /** Constructs a schema that validates a value matching any of the given schemas. */
 export const or = (...types) => () => ['or', ...types];
+/** Constructs a schema that validates a value matching `T` or `undefined`. */
+export const option = (t) => or(t, undefined);

package/types/rtti/validate/test.f.d.ts

@@ -82,6 +82,10 @@ declare const _default: {
             error: () => void;
         };
     };
+    option: {
+        ok: () => void;
+        error: () => void;
+    };
     recursive: {
         arrayOfArrays: () => void;
         recordOfRecords: () => void;

package/types/rtti/validate/test.f.js

@@ -1,5 +1,5 @@
 import { validate } from "./module.f.js";
-import { boolean, number, string, bigint, unknown, array, record, or } from "../module.f.js";
+import { boolean, number, string, bigint, unknown, array, record, or, option } from "../module.f.js";
 const assertOk = ([k]) => { if (k !== 'ok') {
     throw 'expected ok';
 } };
@@ -195,6 +195,18 @@ export default {
             },
         },
     },
+    option: {
+        ok: () => {
+            const t = option(number);
+            assertOk(validate(t)(42));
+            assertOk(validate(t)(undefined));
+        },
+        error: () => {
+            const t = option(number);
+            assertError(validate(t)(null));
+            assertError(validate(t)('42'));
+        },
+    },
     recursive: {
         arrayOfArrays: () => {
             // self-referential schema: an array whose elements are also arrays of the same type