@highstate/cli 0.4.2

package/dist/index-gNMEequI.js

@@ -0,0 +1,272 @@
+const simpleKeyRegExp = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function getPrintable(value) {
+    if (value === null)
+        return `null`;
+    if (value === undefined)
+        return `undefined`;
+    if (value === ``)
+        return `an empty string`;
+    if (typeof value === 'symbol')
+        return `<${value.toString()}>`;
+    if (Array.isArray(value))
+        return `an array`;
+    return JSON.stringify(value);
+}
+function computeKey(state, key) {
+    var _a, _b, _c;
+    if (typeof key === `number`) {
+        return `${(_a = state === null || state === undefined ? undefined : state.p) !== null && _a !== undefined ? _a : `.`}[${key}]`;
+    }
+    else if (simpleKeyRegExp.test(key)) {
+        return `${(_b = state === null || state === undefined ? undefined : state.p) !== null && _b !== undefined ? _b : ``}.${key}`;
+    }
+    else {
+        return `${(_c = state === null || state === undefined ? undefined : state.p) !== null && _c !== undefined ? _c : `.`}[${JSON.stringify(key)}]`;
+    }
+}
+
+function pushError({ errors, p } = {}, message) {
+    errors === null || errors === undefined ? undefined : errors.push(`${p !== null && p !== undefined ? p : `.`}: ${message}`);
+    return false;
+}
+function makeCoercionFn(target, key) {
+    return (v) => {
+        const previous = target[key];
+        target[key] = v;
+        return makeCoercionFn(target, key).bind(null, previous);
+    };
+}
+
+/**
+ * Create a validator that always returns true and never refines the type.
+ */
+function isUnknown() {
+    return makeValidator({
+        test: (value, state) => {
+            return true;
+        },
+    });
+}
+/**
+ * Create a validator that only returns true when the tested value is a string.
+ * Refines the type to `string`.
+ */
+function isString() {
+    return makeValidator({
+        test: (value, state) => {
+            if (typeof value !== `string`)
+                return pushError(state, `Expected a string (got ${getPrintable(value)})`);
+            return true;
+        },
+    });
+}
+/**
+ * Create a validator that only returns true when the tested value is an
+ * array whose all values match the provided subspec. Refines the type to
+ * `Array<T>`, with `T` being the subspec inferred type.
+ *
+ * Supports coercion if the `delimiter` option is set, in which case strings
+ * will be split accordingly.
+ */
+function isArray(spec, { delimiter } = {}) {
+    return makeValidator({
+        test: (value, state) => {
+            var _a;
+            const originalValue = value;
+            if (typeof value === `string` && typeof delimiter !== `undefined`) {
+                if (typeof (state === null || state === undefined ? undefined : state.coercions) !== `undefined`) {
+                    if (typeof (state === null || state === undefined ? undefined : state.coercion) === `undefined`)
+                        return pushError(state, `Unbound coercion result`);
+                    value = value.split(delimiter);
+                }
+            }
+            if (!Array.isArray(value))
+                return pushError(state, `Expected an array (got ${getPrintable(value)})`);
+            let valid = true;
+            for (let t = 0, T = value.length; t < T; ++t) {
+                valid = spec(value[t], Object.assign(Object.assign({}, state), { p: computeKey(state, t), coercion: makeCoercionFn(value, t) })) && valid;
+                if (!valid && (state === null || state === undefined ? undefined : state.errors) == null) {
+                    break;
+                }
+            }
+            if (value !== originalValue)
+                state.coercions.push([(_a = state.p) !== null && _a !== undefined ? _a : `.`, state.coercion.bind(null, value)]);
+            return valid;
+        },
+    });
+}
+/**
+ * Create a validator that only returns true when the tested value is a
+ * tuple whose each value matches the corresponding subspec. Refines the type
+ * into a tuple whose each item has the type inferred by the corresponding
+ * tuple.
+ *
+ * Supports coercion if the `delimiter` option is set, in which case strings
+ * will be split accordingly.
+ */
+function isTuple(spec, { delimiter } = {}) {
+    const lengthValidator = hasExactLength(spec.length);
+    return makeValidator({
+        test: (value, state) => {
+            var _a;
+            if (typeof value === `string` && typeof delimiter !== `undefined`) {
+                if (typeof (state === null || state === undefined ? undefined : state.coercions) !== `undefined`) {
+                    if (typeof (state === null || state === undefined ? undefined : state.coercion) === `undefined`)
+                        return pushError(state, `Unbound coercion result`);
+                    value = value.split(delimiter);
+                    state.coercions.push([(_a = state.p) !== null && _a !== undefined ? _a : `.`, state.coercion.bind(null, value)]);
+                }
+            }
+            if (!Array.isArray(value))
+                return pushError(state, `Expected a tuple (got ${getPrintable(value)})`);
+            let valid = lengthValidator(value, Object.assign({}, state));
+            for (let t = 0, T = value.length; t < T && t < spec.length; ++t) {
+                valid = spec[t](value[t], Object.assign(Object.assign({}, state), { p: computeKey(state, t), coercion: makeCoercionFn(value, t) })) && valid;
+                if (!valid && (state === null || state === undefined ? undefined : state.errors) == null) {
+                    break;
+                }
+            }
+            return valid;
+        },
+    });
+}
+/**
+ * Create a validator that only returns true when the tested value is an
+ * object with any amount of properties that must all match the provided
+ * subspec. Refines the type to `Record<string, T>`, with `T` being the
+ * subspec inferred type.
+ *
+ * Keys can be optionally validated as well by using the `keys` optional
+ * subspec parameter.
+ */
+function isRecord(spec, { keys: keySpec = null, } = {}) {
+    const isArrayValidator = isArray(isTuple([keySpec !== null && keySpec !== undefined ? keySpec : isString(), spec]));
+    return makeValidator({
+        test: (value, state) => {
+            var _a;
+            if (Array.isArray(value)) {
+                if (typeof (state === null || state === undefined ? undefined : state.coercions) !== `undefined`) {
+                    if (typeof (state === null || state === undefined ? undefined : state.coercion) === `undefined`)
+                        return pushError(state, `Unbound coercion result`);
+                    if (!isArrayValidator(value, Object.assign(Object.assign({}, state), { coercion: undefined })))
+                        return false;
+                    value = Object.fromEntries(value);
+                    state.coercions.push([(_a = state.p) !== null && _a !== undefined ? _a : `.`, state.coercion.bind(null, value)]);
+                    return true;
+                }
+            }
+            if (typeof value !== `object` || value === null)
+                return pushError(state, `Expected an object (got ${getPrintable(value)})`);
+            const keys = Object.keys(value);
+            let valid = true;
+            for (let t = 0, T = keys.length; t < T && (valid || (state === null || state === undefined ? undefined : state.errors) != null); ++t) {
+                const key = keys[t];
+                const sub = value[key];
+                if (key === `__proto__` || key === `constructor`) {
+                    valid = pushError(Object.assign(Object.assign({}, state), { p: computeKey(state, key) }), `Unsafe property name`);
+                    continue;
+                }
+                if (keySpec !== null && !keySpec(key, state)) {
+                    valid = false;
+                    continue;
+                }
+                if (!spec(sub, Object.assign(Object.assign({}, state), { p: computeKey(state, key), coercion: makeCoercionFn(value, key) }))) {
+                    valid = false;
+                    continue;
+                }
+            }
+            return valid;
+        },
+    });
+}
+/**
+ * @deprecated Replace `isDict` by `isRecord`
+ */
+function isDict(spec, opts = {}) {
+    return isRecord(spec, opts);
+}
+
+function makeTrait(value) {
+    return () => {
+        return value;
+    };
+}
+function makeValidator({ test }) {
+    return makeTrait(test)();
+}
+/**
+ * Create a validator that checks that the tested array or string has exactly
+ * the specified length.
+ */
+function hasExactLength(length) {
+    return makeValidator({
+        test: (value, state) => {
+            if (!(value.length === length))
+                return pushError(state, `Expected to have a length of exactly ${length} elements (got ${value.length})`);
+            return true;
+        },
+    });
+}
+
+function cascade(spec, ...followups) {
+    const resolvedFollowups = Array.isArray(followups[0])
+        ? followups[0]
+        : followups;
+    return makeValidator({
+        test: (value, state) => {
+            var _a, _b;
+            const context = { value: value };
+            const subCoercion = typeof (state === null || state === undefined ? undefined : state.coercions) !== `undefined`
+                ? makeCoercionFn(context, `value`) : undefined;
+            const subCoercions = typeof (state === null || state === undefined ? undefined : state.coercions) !== `undefined`
+                ? [] : undefined;
+            if (!spec(value, Object.assign(Object.assign({}, state), { coercion: subCoercion, coercions: subCoercions })))
+                return false;
+            const reverts = [];
+            if (typeof subCoercions !== `undefined`)
+                for (const [, coercion] of subCoercions)
+                    reverts.push(coercion());
+            try {
+                if (typeof (state === null || state === void 0 ? void 0 : state.coercions) !== `undefined`) {
+                    if (context.value !== value) {
+                        if (typeof (state === null || state === void 0 ? void 0 : state.coercion) === `undefined`)
+                            return pushError(state, `Unbound coercion result`);
+                        state.coercions.push([(_a = state.p) !== null && _a !== void 0 ? _a : `.`, state.coercion.bind(null, context.value)]);
+                    }
+                    (_b = state === null || state === void 0 ? void 0 : state.coercions) === null || _b === void 0 ? void 0 : _b.push(...subCoercions);
+                }
+                return resolvedFollowups.every(spec => {
+                    return spec(context.value, state);
+                });
+            }
+            finally {
+                for (const revert of reverts) {
+                    revert();
+                }
+            }
+        },
+    });
+}
+function applyCascade(spec, ...followups) {
+    const resolvedFollowups = Array.isArray(followups[0])
+        ? followups[0]
+        : followups;
+    return cascade(spec, resolvedFollowups);
+}
+var KeyRelationship;
+(function (KeyRelationship) {
+    KeyRelationship["Forbids"] = "Forbids";
+    KeyRelationship["Requires"] = "Requires";
+})(KeyRelationship || (KeyRelationship = {}));
+({
+    [KeyRelationship.Forbids]: {
+        expect: false,
+        message: `forbids using`,
+    },
+    [KeyRelationship.Requires]: {
+        expect: true,
+        message: `requires using`,
+    },
+});
+
+export { KeyRelationship, applyCascade, cascade, hasExactLength, isArray, isDict, isRecord, isString, isTuple, isUnknown, makeTrait, makeValidator };