@redocly/openapi-core 1.0.0-beta.111 → 1.0.0-beta.113

package/lib/rules/common/assertions/utils.js

@@ -1,122 +1,154 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.regexFromString = exports.isOrdered = exports.getIntersectionLength = exports.buildSubjectVisitor = exports.buildVisitorObject = void 0;
+exports.regexFromString = exports.isOrdered = exports.getIntersectionLength = exports.buildSubjectVisitor = exports.buildVisitorObject = exports.getAssertsToApply = void 0;
+const asserts_1 = require("./asserts");
 const logger_1 = require("../../../logger");
 const ref_utils_1 = require("../../../ref-utils");
-const asserts_1 = require("./asserts");
-function buildVisitorObject(subject, context, subjectVisitor) {
-    if (!context) {
-        return { [subject]: subjectVisitor };
+const utils_1 = require("../../../utils");
+const assertionMessageTemplates = {
+    problems: '{{problems}}',
+};
+function getPredicatesFromLocators(locators) {
+    const { filterInParentKeys, filterOutParentKeys, matchParentKeys } = locators;
+    const keyMatcher = matchParentKeys && regexFromString(matchParentKeys);
+    const matchKeysPredicate = keyMatcher && ((key) => keyMatcher.test(key.toString()));
+    const filterInPredicate = Array.isArray(filterInParentKeys) &&
+        ((key) => filterInParentKeys.includes(key.toString()));
+    const filterOutPredicate = Array.isArray(filterOutParentKeys) &&
+        ((key) => !filterOutParentKeys.includes(key.toString()));
+    return [matchKeysPredicate, filterInPredicate, filterOutPredicate].filter(utils_1.isTruthy);
+}
+function getAssertsToApply(assertion) {
+    const assertsToApply = utils_1.keysOf(asserts_1.asserts)
+        .filter((assertName) => assertion.assertions[assertName] !== undefined)
+        .map((assertName) => {
+        return {
+            name: assertName,
+            conditions: assertion.assertions[assertName],
+            runsOnKeys: asserts_1.runOnKeysSet.has(assertName),
+            runsOnValues: asserts_1.runOnValuesSet.has(assertName),
+        };
+    });
+    const shouldRunOnKeys = assertsToApply.find((assert) => assert.runsOnKeys && !assert.runsOnValues);
+    const shouldRunOnValues = assertsToApply.find((assert) => assert.runsOnValues && !assert.runsOnKeys);
+    if (shouldRunOnValues && !assertion.subject.property) {
+        throw new Error(`${shouldRunOnValues.name} can't be used on all keys. Please provide a single property`);
+    }
+    if (shouldRunOnKeys && assertion.subject.property) {
+        throw new Error(`${shouldRunOnKeys.name} can't be used on a single property. Please use 'property'.`);
+    }
+    return assertsToApply;
+}
+exports.getAssertsToApply = getAssertsToApply;
+function getAssertionProperties({ subject }) {
+    return (Array.isArray(subject.property) ? subject.property : [subject === null || subject === void 0 ? void 0 : subject.property]).filter(Boolean);
+}
+function applyAssertions(assertionDefinition, asserts, { rawLocation, rawNode, resolve, location, node }) {
+    var _a;
+    const properties = getAssertionProperties(assertionDefinition);
+    const assertResults = [];
+    for (const assert of asserts) {
+        const currentLocation = assert.name === 'ref' ? rawLocation : location;
+        if (properties.length) {
+            for (const property of properties) {
+                // we can have resolvable scalar so need to resolve value here.
+                const value = ref_utils_1.isRef(node[property]) ? (_a = resolve(node[property])) === null || _a === void 0 ? void 0 : _a.node : node[property];
+                assertResults.push(runAssertion({
+                    values: value,
+                    rawValues: rawNode[property],
+                    assert,
+                    location: currentLocation.child(property),
+                }));
+            }
+        }
+        else {
+            const value = assert.name === 'ref' ? rawNode : Object.keys(node);
+            assertResults.push(runAssertion({
+                values: Object.keys(node),
+                rawValues: value,
+                assert,
+                location: currentLocation,
+            }));
+        }
+    }
+    return assertResults.flat();
+}
+function buildVisitorObject(assertion, subjectVisitor) {
+    var _a, _b;
+    const targetVisitorLocatorPredicates = getPredicatesFromLocators(assertion.subject);
+    const targetVisitorSkipFunction = targetVisitorLocatorPredicates.length
+        ? (node, key) => !targetVisitorLocatorPredicates.every((predicate) => predicate(key))
+        : undefined;
+    const targetVisitor = {
+        [assertion.subject.type]: Object.assign({ enter: subjectVisitor }, (targetVisitorSkipFunction && { skip: targetVisitorSkipFunction })),
+    };
+    if (!Array.isArray(assertion.where)) {
+        return targetVisitor;
     }
     let currentVisitorLevel = {};
     const visitor = currentVisitorLevel;
+    const context = assertion.where;
     for (let index = 0; index < context.length; index++) {
-        const node = context[index];
-        if (context.length === index + 1 && node.type === subject) {
-            // Visitors don't work properly for the same type nested nodes, so
-            // as a workaround for that we don't create separate visitor for the last element
-            // which is the same as subject;
-            // we will check includes/excludes it in the last visitor.
-            continue;
+        const assertionDefinitionNode = context[index];
+        if (!utils_1.isString((_a = assertionDefinitionNode.subject) === null || _a === void 0 ? void 0 : _a.type)) {
+            throw new Error(`${assertion.assertionId} -> where -> [${index}]: 'type' (String) is required`);
         }
-        const matchParentKeys = node.matchParentKeys;
-        const excludeParentKeys = node.excludeParentKeys;
-        if (matchParentKeys && excludeParentKeys) {
-            throw new Error(`Both 'matchParentKeys' and 'excludeParentKeys' can't be under one context item`);
-        }
-        if (matchParentKeys || excludeParentKeys) {
-            currentVisitorLevel[node.type] = {
-                skip: (_value, key) => {
-                    if (matchParentKeys) {
-                        return !matchParentKeys.includes(key);
-                    }
-                    if (excludeParentKeys) {
-                        return excludeParentKeys.includes(key);
-                    }
-                },
-            };
+        const locatorPredicates = getPredicatesFromLocators(assertionDefinitionNode.subject);
+        const assertsToApply = getAssertsToApply(assertionDefinitionNode);
+        const skipFunction = (node, key, { location, rawLocation, resolve, rawNode }) => !locatorPredicates.every((predicate) => predicate(key)) ||
+            !!applyAssertions(assertionDefinitionNode, assertsToApply, {
+                location,
+                node,
+                rawLocation,
+                rawNode,
+                resolve,
+            }).length;
+        const nodeVisitor = Object.assign({}, ((locatorPredicates.length || assertsToApply.length) && { skip: skipFunction }));
+        if (assertionDefinitionNode.subject.type === assertion.subject.type &&
+            index === context.length - 1) {
+            // We have to merge the visitors if the last node inside the `where` is the same as the subject.
+            targetVisitor[assertion.subject.type] = Object.assign({ enter: subjectVisitor }, ((nodeVisitor.skip && { skip: nodeVisitor.skip }) ||
+                (targetVisitorSkipFunction && {
+                    skip: (node, key, ctx // We may have locators defined on assertion level and on where level for the same node type
+                    ) => { var _a; return !!(((_a = nodeVisitor.skip) === null || _a === void 0 ? void 0 : _a.call(nodeVisitor, node, key, ctx)) || (targetVisitorSkipFunction === null || targetVisitorSkipFunction === void 0 ? void 0 : targetVisitorSkipFunction(node, key))); },
+                })));
         }
         else {
-            currentVisitorLevel[node.type] = {};
+            currentVisitorLevel = currentVisitorLevel[(_b = assertionDefinitionNode.subject) === null || _b === void 0 ? void 0 : _b.type] =
+                nodeVisitor;
         }
-        currentVisitorLevel = currentVisitorLevel[node.type];
     }
-    currentVisitorLevel[subject] = subjectVisitor;
+    currentVisitorLevel[assertion.subject.type] = targetVisitor[assertion.subject.type];
     return visitor;
 }
 exports.buildVisitorObject = buildVisitorObject;
-function buildSubjectVisitor(assertId, assertion, asserts) {
-    return (node, { report, location, rawLocation, key, type, resolve, rawNode }) => {
-        var _a;
-        let properties = assertion.property;
-        // We need to check context's last node if it has the same type as subject node;
-        // if yes - that means we didn't create context's last node visitor,
-        // so we need to handle 'matchParentKeys' and 'excludeParentKeys' conditions here;
-        if (assertion.context) {
-            const lastContextNode = assertion.context[assertion.context.length - 1];
-            if (lastContextNode.type === type.name) {
-                const matchParentKeys = lastContextNode.matchParentKeys;
-                const excludeParentKeys = lastContextNode.excludeParentKeys;
-                if (matchParentKeys && !matchParentKeys.includes(key)) {
-                    return;
-                }
-                if (excludeParentKeys && excludeParentKeys.includes(key)) {
-                    return;
-                }
-            }
-        }
-        if (properties) {
-            properties = Array.isArray(properties) ? properties : [properties];
-        }
-        const defaultMessage = `${logger_1.colorize.blue(assertId)} failed because the ${logger_1.colorize.blue(assertion.subject)}${logger_1.colorize.blue(properties ? ` ${properties.join(', ')}` : '')} didn't meet the assertions: {{problems}}`;
-        const assertResults = [];
-        for (const assert of asserts) {
-            const currentLocation = assert.name === 'ref' ? rawLocation : location;
-            if (properties) {
-                for (const property of properties) {
-                    // we can have resolvable scalar so need to resolve value here.
-                    const value = ref_utils_1.isRef(node[property]) ? (_a = resolve(node[property])) === null || _a === void 0 ? void 0 : _a.node : node[property];
-                    assertResults.push(runAssertion({
-                        values: value,
-                        rawValues: rawNode[property],
-                        assert,
-                        location: currentLocation.child(property),
-                    }));
-                }
-            }
-            else {
-                const value = assert.name === 'ref' ? rawNode : Object.keys(node);
-                assertResults.push(runAssertion({
-                    values: Object.keys(node),
-                    rawValues: value,
-                    assert,
-                    location: currentLocation,
-                }));
-            }
-        }
-        const problems = assertResults.flat();
+function buildSubjectVisitor(assertId, assertion) {
+    return (node, { report, location, rawLocation, resolve, rawNode }) => {
+        const properties = getAssertionProperties(assertion);
+        const defaultMessage = `${logger_1.colorize.blue(assertId)} failed because the ${logger_1.colorize.blue(assertion.subject.type)} ${logger_1.colorize.blue(properties.join(', '))} didn't meet the assertions: ${assertionMessageTemplates.problems}`.replace(/ +/g, ' ');
+        const problems = applyAssertions(assertion, getAssertsToApply(assertion), {
+            rawLocation,
+            rawNode,
+            resolve,
+            location,
+            node,
+        });
         if (problems.length) {
             const message = assertion.message || defaultMessage;
-            report({
-                message: message.replace('{{problems}}', getProblemsMessage(problems)),
-                location: getProblemsLocation(problems) || location,
-                forceSeverity: assertion.severity || 'error',
-                suggest: assertion.suggest || [],
-                ruleId: assertId,
-            });
+            for (const problem of problems) {
+                const problemMessage = problem.message ? problem.message : defaultMessage;
+                report({
+                    message: message.replace(assertionMessageTemplates.problems, problemMessage),
+                    location: problem.location || location,
+                    forceSeverity: assertion.severity || 'error',
+                    suggest: assertion.suggest || [],
+                    ruleId: assertId,
+                });
+            }
         }
     };
 }
 exports.buildSubjectVisitor = buildSubjectVisitor;
-function getProblemsLocation(problems) {
-    return problems.length ? problems[0].location : undefined;
-}
-function getProblemsMessage(problems) {
-    var _a;
-    return problems.length === 1
-        ? (_a = problems[0].message) !== null && _a !== void 0 ? _a : ''
-        : problems.map((problem) => { var _a; return `\n- ${(_a = problem.message) !== null && _a !== void 0 ? _a : ''}`; }).join('');
-}
 function getIntersectionLength(keys, properties) {
     const props = new Set(properties);
     let count = 0;

package/lib/rules/common/spec.js

@@ -142,6 +142,12 @@ const OasSpec = () => {
                         });
                     }
                 }
+                if (propName === 'nullable' && !node.type) {
+                    report({
+                        message: 'The `type` field must be defined when the `nullable` field is used.',
+                        location: location.child([propName]),
+                    });
+                }
             }
         },
     };

package/lib/rules/oas2/index.d.ts

@@ -3,7 +3,6 @@ export declare const rules: {
     spec: Oas2Rule;
     'no-invalid-schema-examples': any;
     'no-invalid-parameter-examples': any;
-    'info-description': Oas2Rule;
     'info-contact': Oas2Rule;
     'info-license': Oas2Rule;
     'info-license-url': Oas2Rule;

package/lib/rules/oas2/index.js

@@ -4,7 +4,6 @@ exports.preprocessors = exports.rules = void 0;
 const spec_1 = require("../common/spec");
 const no_invalid_schema_examples_1 = require("../common/no-invalid-schema-examples");
 const no_invalid_parameter_examples_1 = require("../common/no-invalid-parameter-examples");
-const info_description_1 = require("../common/info-description");
 const info_contact_1 = require("../common/info-contact");
 const info_license_1 = require("../common/info-license");
 const info_license_url_1 = require("../common/info-license-url");
@@ -46,7 +45,6 @@ exports.rules = {
     spec: spec_1.OasSpec,
     'no-invalid-schema-examples': no_invalid_schema_examples_1.NoInvalidSchemaExamples,
     'no-invalid-parameter-examples': no_invalid_parameter_examples_1.NoInvalidParameterExamples,
-    'info-description': info_description_1.InfoDescription,
     'info-contact': info_contact_1.InfoContact,
     'info-license': info_license_1.InfoLicense,
     'info-license-url': info_license_url_1.InfoLicenseUrl,

package/lib/rules/oas3/index.js

@@ -17,7 +17,6 @@ const operation_operationId_url_safe_1 = require("../common/operation-operationI
 const tags_alphabetical_1 = require("../common/tags-alphabetical");
 const no_server_example_com_1 = require("./no-server-example.com");
 const no_server_trailing_slash_1 = require("./no-server-trailing-slash");
-const info_description_1 = require("../common/info-description");
 const tag_description_1 = require("../common/tag-description");
 const info_contact_1 = require("../common/info-contact");
 const info_license_1 = require("../common/info-license");
@@ -54,7 +53,6 @@ const spec_components_invalid_map_name_1 = require("./spec-components-invalid-ma
 const operation_4xx_problem_details_rfc7807_1 = require("./operation-4xx-problem-details-rfc7807");
 exports.rules = {
     spec: spec_1.OasSpec,
-    'info-description': info_description_1.InfoDescription,
     'info-contact': info_contact_1.InfoContact,
     'info-license': info_license_1.InfoLicense,
     'info-license-url': info_license_url_1.InfoLicenseUrl,

package/lib/rules/utils.js

@@ -101,6 +101,9 @@ function validateExample(example, schema, dataLoc, { resolve, location, report }
         }
     }
     catch (e) {
+        if (e.message === 'discriminator: requires oneOf or anyOf composite keyword') {
+            return;
+        }
         report({
             message: `Example validation errored: ${e.message}.`,
             location: location.child('schema'),

package/lib/types/oas2.js

@@ -17,8 +17,8 @@ const Root = {
         parameters: 'NamedParameters',
         responses: 'NamedResponses',
         securityDefinitions: 'NamedSecuritySchemes',
-        security: _1.listOf('SecurityRequirement'),
-        tags: _1.listOf('Tag'),
+        security: 'SecurityRequirementList',
+        tags: 'TagList',
         externalDocs: 'ExternalDocs',
     },
     required: ['swagger', 'paths', 'info'],
@@ -55,7 +55,7 @@ const Paths = {
 const PathItem = {
     properties: {
         $ref: { type: 'string' },
-        parameters: _1.listOf('Parameter'),
+        parameters: 'ParameterList',
         get: 'Operation',
         put: 'Operation',
         post: 'Operation',
@@ -74,13 +74,13 @@ const Operation = {
         operationId: { type: 'string' },
         consumes: { type: 'array', items: { type: 'string' } },
         produces: { type: 'array', items: { type: 'string' } },
-        parameters: _1.listOf('Parameter'),
+        parameters: 'ParameterList',
         responses: 'Responses',
         schemes: { type: 'array', items: { type: 'string' } },
         deprecated: { type: 'boolean' },
-        security: _1.listOf('SecurityRequirement'),
-        'x-codeSamples': _1.listOf('XCodeSample'),
-        'x-code-samples': _1.listOf('XCodeSample'),
+        security: 'SecurityRequirementList',
+        'x-codeSamples': 'XCodeSampleList',
+        'x-code-samples': 'XCodeSampleList',
         'x-hideTryItPanel': { type: 'boolean' },
     },
     required: ['responses'],
@@ -354,8 +354,10 @@ const SecurityRequirement = {
 exports.Oas2Types = {
     Root,
     Tag,
+    TagList: _1.listOf('Tag'),
     ExternalDocs,
     SecurityRequirement,
+    SecurityRequirementList: _1.listOf('SecurityRequirement'),
     Info,
     Contact,
     License,
@@ -363,6 +365,7 @@ exports.Oas2Types = {
     PathItem,
     Parameter,
     ParameterItems,
+    ParameterList: _1.listOf('Parameter'),
     Operation,
     Examples,
     Header,
@@ -377,4 +380,5 @@ exports.Oas2Types = {
     NamedSecuritySchemes: _1.mapOf('SecurityScheme'),
     SecurityScheme,
     XCodeSample,
+    XCodeSampleList: _1.listOf('XCodeSample'),
 };

package/lib/types/oas3.js

@@ -8,9 +8,9 @@ const Root = {
     properties: {
         openapi: null,
         info: 'Info',
-        servers: _1.listOf('Server'),
-        security: _1.listOf('SecurityRequirement'),
-        tags: _1.listOf('Tag'),
+        servers: 'ServerList',
+        security: 'SecurityRequirementList',
+        tags: 'TagList',
         externalDocs: 'ExternalDocs',
         paths: 'Paths',
         components: 'Components',
@@ -92,8 +92,8 @@ const WebhooksMap = {
 const PathItem = {
     properties: {
         $ref: { type: 'string' },
-        servers: _1.listOf('Server'),
-        parameters: _1.listOf('Parameter'),
+        servers: 'ServerList',
+        parameters: 'ParameterList',
         summary: { type: 'string' },
         description: { type: 'string' },
         get: 'Operation',
@@ -137,15 +137,15 @@ const Operation = {
         description: { type: 'string' },
         externalDocs: 'ExternalDocs',
         operationId: { type: 'string' },
-        parameters: _1.listOf('Parameter'),
-        security: _1.listOf('SecurityRequirement'),
-        servers: _1.listOf('Server'),
+        parameters: 'ParameterList',
+        security: 'SecurityRequirementList',
+        servers: 'ServerList',
         requestBody: 'RequestBody',
         responses: 'Responses',
         deprecated: { type: 'boolean' },
         callbacks: 'CallbacksMap',
-        'x-codeSamples': _1.listOf('XCodeSample'),
-        'x-code-samples': _1.listOf('XCodeSample'),
+        'x-codeSamples': 'XCodeSampleList',
+        'x-code-samples': 'XCodeSampleList',
         'x-hideTryItPanel': { type: 'boolean' },
     },
     required: ['responses'],
@@ -430,17 +430,21 @@ const SecurityScheme = {
 exports.Oas3Types = {
     Root,
     Tag,
+    TagList: _1.listOf('Tag'),
     ExternalDocs,
     Server,
+    ServerList: _1.listOf('Server'),
     ServerVariable,
     ServerVariablesMap: _1.mapOf('ServerVariable'),
     SecurityRequirement,
+    SecurityRequirementList: _1.listOf('SecurityRequirement'),
     Info,
     Contact,
     License,
     Paths,
     PathItem,
     Parameter,
+    ParameterList: _1.listOf('Parameter'),
     Operation,
     Callback: _1.mapOf('PathItem'),
     CallbacksMap: _1.mapOf('Callback'),
@@ -479,5 +483,6 @@ exports.Oas3Types = {
     OAuth2Flows,
     SecurityScheme,
     XCodeSample,
+    XCodeSampleList: _1.listOf('XCodeSample'),
     WebhooksMap,
 };

package/lib/types/oas3_1.js

@@ -78,6 +78,7 @@ const Operation = {
 const Schema = {
     properties: {
         $id: { type: 'string' },
+        $anchor: { type: 'string' },
         id: { type: 'string' },
         $schema: { type: 'string' },
         definitions: 'NamedSchemas',

package/lib/types/redocly-yaml.js

@@ -5,7 +5,6 @@ const _1 = require(".");
 const utils_1 = require("../utils");
 const builtInRulesList = [
     'spec',
-    'info-description',
     'info-contact',
     'info-license',
     'info-license-url',
@@ -60,17 +59,21 @@ const builtInRulesList = [
 const nodeTypesList = [
     'Root',
     'Tag',
+    'TagList',
     'ExternalDocs',
     'Server',
+    'ServerList',
     'ServerVariable',
     'ServerVariablesMap',
     'SecurityRequirement',
+    'SecurityRequirementList',
     'Info',
     'Contact',
     'License',
     'Paths',
     'PathItem',
     'Parameter',
+    'ParameterList',
     'Operation',
     'Callback',
     'CallbacksMap',
@@ -109,6 +112,7 @@ const nodeTypesList = [
     'OAuth2Flows',
     'SecurityScheme',
     'XCodeSample',
+    'XCodeSampleList',
     'WebhooksMap',
 ];
 const ConfigStyleguide = {
@@ -140,11 +144,7 @@ const RootConfigStyleguide = {
         } }, ConfigStyleguide.properties),
 };
 const ConfigRoot = {
-    properties: Object.assign(Object.assign({ organization: { type: 'string' }, apis: 'ConfigApis', apiDefinitions: {
-            type: 'object',
-            properties: {},
-            additionalProperties: { properties: { type: 'string' } },
-        } }, RootConfigStyleguide.properties), { styleguide: 'RootConfigStyleguide', lint: 'RootConfigStyleguide', 'features.openapi': 'ConfigReferenceDocs', referenceDocs: 'ConfigReferenceDocs', 'features.mockServer': 'ConfigMockServer', region: { enum: ['us', 'eu'] }, resolve: {
+    properties: Object.assign(Object.assign({ organization: { type: 'string' }, apis: 'ConfigApis' }, RootConfigStyleguide.properties), { 'features.openapi': 'ConfigReferenceDocs', 'features.mockServer': 'ConfigMockServer', region: { enum: ['us', 'eu'] }, resolve: {
             properties: {
                 http: 'ConfigHTTP',
                 doNotResolveExamples: { type: 'boolean' },
@@ -209,16 +209,9 @@ const ObjectRule = {
     additionalProperties: {},
     required: ['severity'],
 };
-const Assert = {
+const AssertionDefinitionSubject = {
     properties: {
-        subject: (value) => {
-            if (Array.isArray(value)) {
-                return { type: 'array', items: { enum: nodeTypesList } };
-            }
-            else {
-                return { enum: nodeTypesList };
-            }
-        },
+        type: { enum: nodeTypesList },
         property: (value) => {
             if (Array.isArray(value)) {
                 return { type: 'array', items: { type: 'string' } };
@@ -230,10 +223,14 @@ const Assert = {
                 return { type: 'string' };
             }
         },
-        context: _1.listOf('Context'),
-        message: { type: 'string' },
-        suggest: { type: 'array', items: { type: 'string' } },
-        severity: { enum: ['error', 'warn', 'off'] },
+        filterInParentKeys: { type: 'array', items: { type: 'string' } },
+        filterOutParentKeys: { type: 'array', items: { type: 'string' } },
+        matchParentKeys: { type: 'string' },
+    },
+    required: ['type'],
+};
+const AssertionDefinitionAssertions = {
+    properties: {
         enum: { type: 'array', items: { type: 'string' } },
         pattern: { type: 'string' },
         casing: {
@@ -253,26 +250,49 @@ const Assert = {
         requireAny: { type: 'array', items: { type: 'string' } },
         disallowed: { type: 'array', items: { type: 'string' } },
         defined: { type: 'boolean' },
-        undefined: { type: 'boolean' },
+        // undefined: { type: 'boolean' }, // TODO: Remove `undefined` assertion from codebase overall
         nonEmpty: { type: 'boolean' },
         minLength: { type: 'integer' },
         maxLength: { type: 'integer' },
         ref: (value) => typeof value === 'string' ? { type: 'string' } : { type: 'boolean' },
+        const: (value) => {
+            if (typeof value === 'string') {
+                return { type: 'string' };
+            }
+            if (typeof value === 'number') {
+                return { type: 'number' };
+            }
+            if (typeof value === 'boolean') {
+                return { type: 'boolean' };
+            }
+            else {
+                return;
+            }
+        },
     },
     additionalProperties: (_value, key) => {
         if (/^\w+\/\w+$/.test(key))
             return { type: 'object' };
         return;
     },
-    required: ['subject'],
 };
-const Context = {
+const AssertDefinition = {
     properties: {
-        type: { enum: nodeTypesList },
-        matchParentKeys: { type: 'array', items: { type: 'string' } },
-        excludeParentKeys: { type: 'array', items: { type: 'string' } },
+        subject: 'AssertionDefinitionSubject',
+        assertions: 'AssertionDefinitionAssertions',
     },
-    required: ['type'],
+    required: ['subject', 'assertions'],
+};
+const Assert = {
+    properties: {
+        subject: 'AssertionDefinitionSubject',
+        assertions: 'AssertionDefinitionAssertions',
+        where: _1.listOf('AssertDefinition'),
+        message: { type: 'string' },
+        suggest: { type: 'array', items: { type: 'string' } },
+        severity: { enum: ['error', 'warn', 'off'] },
+    },
+    required: ['subject', 'assertions'],
 };
 const ConfigLanguage = {
     properties: {
@@ -792,7 +812,7 @@ exports.ConfigTypes = {
     ConfigSidebarLinks,
     CommonConfigSidebarLinks,
     ConfigTheme,
-    Context,
+    AssertDefinition,
     ThemeColors,
     CommonThemeColors,
     BorderThemeColors,
@@ -839,4 +859,6 @@ exports.ConfigTypes = {
     Sidebar,
     Heading,
     Typography,
+    AssertionDefinitionAssertions,
+    AssertionDefinitionSubject,
 };

package/lib/utils.d.ts

@@ -46,4 +46,6 @@ export declare function showErrorForDeprecatedField(deprecatedField: string, upd
 export declare type Falsy = undefined | null | false | '' | 0;
 export declare function isTruthy<Truthy>(value: Truthy | Falsy): value is Truthy;
 export declare function identity<T>(value: T): T;
+export declare function keysOf<T>(obj: T): (keyof T)[];
 export declare function pickDefined<T extends Record<string, unknown>>(obj?: T): Record<string, unknown> | undefined;
+export declare function nextTick(): void;