@redocly/config 0.43.0 → 0.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/lib/common.d.ts +241 -22
  2. package/lib/common.js +50 -37
  3. package/lib/constants/config.d.ts +12 -0
  4. package/lib/constants/config.js +17 -0
  5. package/lib/constants/entities.d.ts +45 -0
  6. package/lib/constants/entities.js +58 -0
  7. package/lib/constants/enum.d.ts +1 -0
  8. package/lib/constants/enum.js +6 -0
  9. package/lib/constants/shared.d.ts +15 -0
  10. package/lib/constants/shared.js +22 -0
  11. package/lib/default-theme-config-schema.d.ts +866 -723
  12. package/lib/default-theme-config-schema.js +1 -1
  13. package/lib/entities-catalog-entity-file-schema.js +22 -22
  14. package/lib/ex-theme-config-schemas.d.ts +96 -26
  15. package/lib/ex-theme-config-schemas.js +23 -2
  16. package/lib/index.d.ts +3 -1
  17. package/lib/index.js +13 -10
  18. package/lib/product-override-schema.d.ts +73 -20
  19. package/lib/root-config-schema.d.ts +2823 -1567
  20. package/lib/root-config-schema.js +18 -11
  21. package/lib/scorecards-config-schema.d.ts +6 -0
  22. package/lib/scorecards-config-schema.js +2 -4
  23. package/lib/types/portal-shared-types.d.ts +1 -1
  24. package/lib-esm/common.d.ts +241 -22
  25. package/lib-esm/common.js +29 -16
  26. package/lib-esm/constants/config.d.ts +12 -0
  27. package/lib-esm/constants/config.js +14 -0
  28. package/lib-esm/constants/entities.d.ts +45 -0
  29. package/lib-esm/constants/entities.js +55 -0
  30. package/lib-esm/constants/enum.d.ts +1 -0
  31. package/lib-esm/constants/enum.js +2 -0
  32. package/lib-esm/constants/shared.d.ts +15 -0
  33. package/lib-esm/constants/shared.js +19 -0
  34. package/lib-esm/default-theme-config-schema.d.ts +866 -723
  35. package/lib-esm/default-theme-config-schema.js +1 -1
  36. package/lib-esm/entities-catalog-entity-file-schema.js +21 -21
  37. package/lib-esm/ex-theme-config-schemas.d.ts +96 -26
  38. package/lib-esm/ex-theme-config-schemas.js +24 -3
  39. package/lib-esm/index.d.ts +3 -1
  40. package/lib-esm/index.js +3 -1
  41. package/lib-esm/product-override-schema.d.ts +73 -20
  42. package/lib-esm/root-config-schema.d.ts +2823 -1567
  43. package/lib-esm/root-config-schema.js +14 -7
  44. package/lib-esm/scorecards-config-schema.d.ts +6 -0
  45. package/lib-esm/scorecards-config-schema.js +2 -4
  46. package/lib-esm/types/portal-shared-types.d.ts +1 -1
  47. package/package.json +2 -2
  48. package/lib/constants.d.ts +0 -38
  49. package/lib/constants.js +0 -73
  50. package/lib-esm/constants.d.ts +0 -38
  51. package/lib-esm/constants.js +0 -70
@@ -46,8 +46,8 @@ exports.themeConfigSchema = {
46
46
  * @deprecated Should use `scorecardClassic` instead
47
47
  */
48
48
  scorecard: ex_theme_config_schemas_1.scorecardConfigSchema,
49
- scorecards: scorecards_config_schema_1.scorecardsConfigSchema,
50
49
  scorecardClassic: ex_theme_config_schemas_1.scorecardConfigSchema,
50
+ scorecards: scorecards_config_schema_1.scorecardsConfigSchema,
51
51
  },
52
52
  additionalProperties: true,
53
53
  };
@@ -1,10 +1,10 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.entityFileDefaultSchema = exports.entityFileSchema = exports.entityBaseProperties = exports.entityRelationFileSchema = exports.entityLinkFileSchema = exports.entityContactFileSchema = exports.slackContactFileSchema = exports.slackChannelFileSchema = exports.defaultMetadataSchema = exports.dataSchemaMetadataSchema = exports.apiOperationMetadataSchema = exports.apiDescriptionMetadataSchema = exports.userMetadataSchema = void 0;
4
- const constants_1 = require("./constants");
4
+ const entities_1 = require("./constants/entities");
5
5
  exports.userMetadataSchema = {
6
6
  type: 'object',
7
- nodeTypeName: constants_1.NODE_TYPE_NAMES.USER_ENTITY_METADATA,
7
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.UserEntityMetadata,
8
8
  properties: {
9
9
  email: {
10
10
  type: 'string',
@@ -16,7 +16,7 @@ exports.userMetadataSchema = {
16
16
  };
17
17
  exports.apiDescriptionMetadataSchema = {
18
18
  type: 'object',
19
- nodeTypeName: constants_1.NODE_TYPE_NAMES.API_DESCRIPTION_METADATA,
19
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.ApiDescriptionEntityMetadata,
20
20
  properties: {
21
21
  specType: {
22
22
  type: 'string',
@@ -33,7 +33,7 @@ exports.apiDescriptionMetadataSchema = {
33
33
  };
34
34
  exports.apiOperationMetadataSchema = {
35
35
  type: 'object',
36
- nodeTypeName: constants_1.NODE_TYPE_NAMES.API_OPERATION_METADATA,
36
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.ApiOperationEntityMetadata,
37
37
  properties: {
38
38
  method: {
39
39
  type: 'string',
@@ -64,7 +64,7 @@ exports.apiOperationMetadataSchema = {
64
64
  };
65
65
  exports.dataSchemaMetadataSchema = {
66
66
  type: 'object',
67
- nodeTypeName: constants_1.NODE_TYPE_NAMES.DATA_SCHEMA_METADATA,
67
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.DataSchemaEntityMetadata,
68
68
  properties: {
69
69
  specType: {
70
70
  type: 'string',
@@ -86,12 +86,12 @@ exports.dataSchemaMetadataSchema = {
86
86
  exports.defaultMetadataSchema = {
87
87
  type: 'object',
88
88
  properties: {},
89
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_METADATA,
89
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityMetadata,
90
90
  additionalProperties: true,
91
91
  };
92
92
  exports.slackChannelFileSchema = {
93
93
  type: 'object',
94
- nodeTypeName: constants_1.NODE_TYPE_NAMES.SLACK_CHANNEL,
94
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntitySlackChannel,
95
95
  properties: {
96
96
  name: {
97
97
  type: 'string',
@@ -107,7 +107,7 @@ exports.slackChannelFileSchema = {
107
107
  };
108
108
  exports.slackContactFileSchema = {
109
109
  type: 'object',
110
- nodeTypeName: constants_1.NODE_TYPE_NAMES.SLACK_CONTACT,
110
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntitySlackContact,
111
111
  properties: {
112
112
  channels: {
113
113
  type: 'array',
@@ -119,7 +119,7 @@ exports.slackContactFileSchema = {
119
119
  };
120
120
  exports.entityContactFileSchema = {
121
121
  type: 'object',
122
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_CONTACT,
122
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityContact,
123
123
  properties: {
124
124
  slack: exports.slackContactFileSchema,
125
125
  },
@@ -127,7 +127,7 @@ exports.entityContactFileSchema = {
127
127
  };
128
128
  exports.entityLinkFileSchema = {
129
129
  type: 'object',
130
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_LINK,
130
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityLink,
131
131
  properties: {
132
132
  label: {
133
133
  type: 'string',
@@ -143,11 +143,11 @@ exports.entityLinkFileSchema = {
143
143
  };
144
144
  exports.entityRelationFileSchema = {
145
145
  type: 'object',
146
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_RELATION,
146
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityRelation,
147
147
  properties: {
148
148
  type: {
149
149
  type: 'string',
150
- enum: constants_1.ENTITY_RELATION_TYPES,
150
+ enum: entities_1.ENTITY_RELATION_TYPES,
151
151
  },
152
152
  key: {
153
153
  type: 'string',
@@ -206,12 +206,12 @@ exports.entityBaseProperties = {
206
206
  contact: exports.entityContactFileSchema,
207
207
  links: {
208
208
  type: 'array',
209
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_LINK_LIST,
209
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityLinkList,
210
210
  items: exports.entityLinkFileSchema,
211
211
  },
212
212
  relations: {
213
213
  type: 'array',
214
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY_RELATION_LIST,
214
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.EntityRelationList,
215
215
  items: exports.entityRelationFileSchema,
216
216
  },
217
217
  metadata: exports.defaultMetadataSchema,
@@ -227,46 +227,46 @@ exports.entityFileSchema = {
227
227
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'user' }, metadata: exports.userMetadataSchema }),
228
228
  required: ['key', 'title', 'type', 'metadata'],
229
229
  additionalProperties: false,
230
- nodeTypeName: constants_1.NODE_TYPE_NAMES.USER_ENTITY,
230
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.UserEntity,
231
231
  },
232
232
  {
233
233
  type: 'object',
234
- nodeTypeName: constants_1.NODE_TYPE_NAMES.API_OPERATION_ENTITY,
234
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.ApiOperationEntity,
235
235
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'api-operation' }, metadata: exports.apiOperationMetadataSchema }),
236
236
  required: ['key', 'title', 'type', 'metadata'],
237
237
  additionalProperties: false,
238
238
  },
239
239
  {
240
240
  type: 'object',
241
- nodeTypeName: constants_1.NODE_TYPE_NAMES.DATA_SCHEMA_ENTITY,
241
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.DataSchemaEntity,
242
242
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'data-schema' }, metadata: exports.dataSchemaMetadataSchema }),
243
243
  required: ['key', 'title', 'type', 'metadata'],
244
244
  additionalProperties: false,
245
245
  },
246
246
  {
247
247
  type: 'object',
248
- nodeTypeName: constants_1.NODE_TYPE_NAMES.API_DESCRIPTION_ENTITY,
248
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.ApiDescriptionEntity,
249
249
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'api-description' }, metadata: exports.apiDescriptionMetadataSchema }),
250
250
  required: ['key', 'title', 'type', 'metadata'],
251
251
  additionalProperties: false,
252
252
  },
253
253
  {
254
254
  type: 'object',
255
- nodeTypeName: constants_1.NODE_TYPE_NAMES.SERVICE_ENTITY,
255
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.ServiceEntity,
256
256
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'service' } }),
257
257
  required: ['key', 'title', 'type'],
258
258
  additionalProperties: false,
259
259
  },
260
260
  {
261
261
  type: 'object',
262
- nodeTypeName: constants_1.NODE_TYPE_NAMES.DOMAIN_ENTITY,
262
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.DomainEntity,
263
263
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'domain' } }),
264
264
  required: ['key', 'title', 'type'],
265
265
  additionalProperties: false,
266
266
  },
267
267
  {
268
268
  type: 'object',
269
- nodeTypeName: constants_1.NODE_TYPE_NAMES.TEAM_ENTITY,
269
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.TeamEntity,
270
270
  properties: Object.assign(Object.assign({}, exports.entityBaseProperties), { type: { const: 'team' } }),
271
271
  required: ['key', 'title', 'type'],
272
272
  additionalProperties: false,
@@ -275,7 +275,7 @@ exports.entityFileSchema = {
275
275
  };
276
276
  exports.entityFileDefaultSchema = {
277
277
  type: 'object',
278
- nodeTypeName: constants_1.NODE_TYPE_NAMES.ENTITY,
278
+ nodeTypeName: entities_1.ENTITY_NODE_TYPE_NAMES.Entity,
279
279
  properties: Object.assign({}, exports.entityBaseProperties),
280
280
  required: ['key', 'title', 'type'],
281
281
  additionalProperties: false,
@@ -4202,6 +4202,9 @@ export declare const catalogsConfigSchema: {
4202
4202
  };
4203
4203
  };
4204
4204
  export declare const scorecardConfigSchema: {
4205
+ readonly nodeTypeName: "ScorecardClassic";
4206
+ readonly description: "Add and create sets of rules and test your API description files against them. With these rules you can maintain quality across your existing APIs and ensure that newly-added or updated APIs match your criteria. An API scorecard can include multiple sets of rules, corresponding to different quality levels.";
4207
+ readonly documentationLink: "https://redocly.com/docs/realm/config/scorecard-classic";
4205
4208
  readonly type: "object";
4206
4209
  readonly additionalProperties: true;
4207
4210
  readonly required: readonly [];
@@ -4214,6 +4217,9 @@ export declare const scorecardConfigSchema: {
4214
4217
  readonly default: false;
4215
4218
  };
4216
4219
  readonly teamMetadataProperty: {
4220
+ readonly nodeTypeName: "ScorecardClassicTeamMetadataProperty";
4221
+ readonly description: "Provide custom team label and team metadata property.";
4222
+ readonly documentationLink: "https://redocly.com/docs/realm/config/scorecard-classic#team-metadata-object";
4217
4223
  readonly type: "object";
4218
4224
  readonly properties: {
4219
4225
  readonly property: {
@@ -4228,92 +4234,126 @@ export declare const scorecardConfigSchema: {
4228
4234
  };
4229
4235
  };
4230
4236
  readonly levels: {
4237
+ readonly nodeTypeName: "ScorecardClassicLevelList";
4238
+ readonly description: "List of levels to score against.";
4231
4239
  readonly type: "array";
4232
4240
  readonly items: {
4241
+ readonly nodeTypeName: "ScorecardClassicLevel";
4242
+ readonly documentationLink: "https://redocly.com/docs/realm/config/scorecard-classic#level-object";
4233
4243
  readonly type: "object";
4234
4244
  readonly required: readonly ["name"];
4235
4245
  readonly properties: {
4236
- readonly decorators: {
4246
+ readonly extends: {
4247
+ readonly nodeTypeName: undefined;
4248
+ readonly type: "array";
4249
+ readonly items: {
4250
+ readonly type: "string";
4251
+ };
4252
+ readonly description: "Use extends to inherit rules and their configurations from other rulesets.";
4253
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/extends";
4254
+ };
4255
+ readonly preprocessors: {
4256
+ readonly nodeTypeName: undefined;
4237
4257
  readonly type: "object";
4238
4258
  readonly additionalProperties: true;
4239
4259
  };
4240
- readonly oas2Decorators: {
4260
+ readonly oas2Preprocessors: {
4261
+ readonly nodeTypeName: undefined;
4241
4262
  readonly type: "object";
4242
4263
  readonly additionalProperties: true;
4243
4264
  };
4244
- readonly oas3_0Decorators: {
4265
+ readonly oas3_0Preprocessors: {
4266
+ readonly nodeTypeName: undefined;
4245
4267
  readonly type: "object";
4246
4268
  readonly additionalProperties: true;
4247
4269
  };
4248
- readonly oas3_1Decorators: {
4270
+ readonly oas3_1Preprocessors: {
4271
+ readonly nodeTypeName: undefined;
4249
4272
  readonly type: "object";
4250
4273
  readonly additionalProperties: true;
4251
4274
  };
4252
- readonly oas3_2Decorators: {
4275
+ readonly oas3_2Preprocessors: {
4276
+ readonly nodeTypeName: undefined;
4253
4277
  readonly type: "object";
4254
4278
  readonly additionalProperties: true;
4255
4279
  };
4256
- readonly async2Decorators: {
4280
+ readonly async2Preprocessors: {
4281
+ readonly nodeTypeName: undefined;
4257
4282
  readonly type: "object";
4258
4283
  readonly additionalProperties: true;
4259
4284
  };
4260
- readonly async3Decorators: {
4285
+ readonly async3Preprocessors: {
4286
+ readonly nodeTypeName: undefined;
4261
4287
  readonly type: "object";
4262
4288
  readonly additionalProperties: true;
4263
4289
  };
4264
- readonly arazzo1Decorators: {
4290
+ readonly arazzo1Preprocessors: {
4291
+ readonly nodeTypeName: undefined;
4265
4292
  readonly type: "object";
4266
4293
  readonly additionalProperties: true;
4267
4294
  };
4268
- readonly overlay1Decorators: {
4295
+ readonly overlay1Preprocessors: {
4296
+ readonly nodeTypeName: undefined;
4269
4297
  readonly type: "object";
4270
4298
  readonly additionalProperties: true;
4271
4299
  };
4272
- readonly openrpc1Decorators: {
4300
+ readonly openrpc1Preprocessors: {
4301
+ readonly nodeTypeName: undefined;
4273
4302
  readonly type: "object";
4274
4303
  readonly additionalProperties: true;
4275
4304
  };
4276
- readonly preprocessors: {
4305
+ readonly decorators: {
4306
+ readonly nodeTypeName: undefined;
4277
4307
  readonly type: "object";
4278
4308
  readonly additionalProperties: true;
4279
4309
  };
4280
- readonly oas2Preprocessors: {
4310
+ readonly oas2Decorators: {
4311
+ readonly nodeTypeName: undefined;
4281
4312
  readonly type: "object";
4282
4313
  readonly additionalProperties: true;
4283
4314
  };
4284
- readonly oas3_0Preprocessors: {
4315
+ readonly oas3_0Decorators: {
4316
+ readonly nodeTypeName: undefined;
4285
4317
  readonly type: "object";
4286
4318
  readonly additionalProperties: true;
4287
4319
  };
4288
- readonly oas3_1Preprocessors: {
4320
+ readonly oas3_1Decorators: {
4321
+ readonly nodeTypeName: undefined;
4289
4322
  readonly type: "object";
4290
4323
  readonly additionalProperties: true;
4291
4324
  };
4292
- readonly oas3_2Preprocessors: {
4325
+ readonly oas3_2Decorators: {
4326
+ readonly nodeTypeName: undefined;
4293
4327
  readonly type: "object";
4294
4328
  readonly additionalProperties: true;
4295
4329
  };
4296
- readonly async2Preprocessors: {
4330
+ readonly async2Decorators: {
4331
+ readonly nodeTypeName: undefined;
4297
4332
  readonly type: "object";
4298
4333
  readonly additionalProperties: true;
4299
4334
  };
4300
- readonly async3Preprocessors: {
4335
+ readonly async3Decorators: {
4336
+ readonly nodeTypeName: undefined;
4301
4337
  readonly type: "object";
4302
4338
  readonly additionalProperties: true;
4303
4339
  };
4304
- readonly arazzo1Preprocessors: {
4340
+ readonly arazzo1Decorators: {
4341
+ readonly nodeTypeName: undefined;
4305
4342
  readonly type: "object";
4306
4343
  readonly additionalProperties: true;
4307
4344
  };
4308
- readonly overlay1Preprocessors: {
4345
+ readonly overlay1Decorators: {
4346
+ readonly nodeTypeName: undefined;
4309
4347
  readonly type: "object";
4310
4348
  readonly additionalProperties: true;
4311
4349
  };
4312
- readonly openrpc1Preprocessors: {
4350
+ readonly openrpc1Decorators: {
4351
+ readonly nodeTypeName: undefined;
4313
4352
  readonly type: "object";
4314
4353
  readonly additionalProperties: true;
4315
4354
  };
4316
4355
  readonly rules: {
4356
+ readonly nodeTypeName: undefined;
4317
4357
  readonly type: "object";
4318
4358
  readonly additionalProperties: {
4319
4359
  readonly oneOf: readonly [{
@@ -4322,8 +4362,11 @@ export declare const scorecardConfigSchema: {
4322
4362
  readonly type: "object";
4323
4363
  }];
4324
4364
  };
4365
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4366
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4325
4367
  };
4326
4368
  readonly oas2Rules: {
4369
+ readonly nodeTypeName: undefined;
4327
4370
  readonly type: "object";
4328
4371
  readonly additionalProperties: {
4329
4372
  readonly oneOf: readonly [{
@@ -4332,8 +4375,11 @@ export declare const scorecardConfigSchema: {
4332
4375
  readonly type: "object";
4333
4376
  }];
4334
4377
  };
4378
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4379
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4335
4380
  };
4336
4381
  readonly oas3_0Rules: {
4382
+ readonly nodeTypeName: undefined;
4337
4383
  readonly type: "object";
4338
4384
  readonly additionalProperties: {
4339
4385
  readonly oneOf: readonly [{
@@ -4342,8 +4388,11 @@ export declare const scorecardConfigSchema: {
4342
4388
  readonly type: "object";
4343
4389
  }];
4344
4390
  };
4391
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4392
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4345
4393
  };
4346
4394
  readonly oas3_1Rules: {
4395
+ readonly nodeTypeName: undefined;
4347
4396
  readonly type: "object";
4348
4397
  readonly additionalProperties: {
4349
4398
  readonly oneOf: readonly [{
@@ -4352,8 +4401,11 @@ export declare const scorecardConfigSchema: {
4352
4401
  readonly type: "object";
4353
4402
  }];
4354
4403
  };
4404
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4405
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4355
4406
  };
4356
4407
  readonly oas3_2Rules: {
4408
+ readonly nodeTypeName: undefined;
4357
4409
  readonly type: "object";
4358
4410
  readonly additionalProperties: {
4359
4411
  readonly oneOf: readonly [{
@@ -4362,8 +4414,11 @@ export declare const scorecardConfigSchema: {
4362
4414
  readonly type: "object";
4363
4415
  }];
4364
4416
  };
4417
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4418
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4365
4419
  };
4366
4420
  readonly async2Rules: {
4421
+ readonly nodeTypeName: undefined;
4367
4422
  readonly type: "object";
4368
4423
  readonly additionalProperties: {
4369
4424
  readonly oneOf: readonly [{
@@ -4372,8 +4427,11 @@ export declare const scorecardConfigSchema: {
4372
4427
  readonly type: "object";
4373
4428
  }];
4374
4429
  };
4430
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4431
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4375
4432
  };
4376
4433
  readonly async3Rules: {
4434
+ readonly nodeTypeName: undefined;
4377
4435
  readonly type: "object";
4378
4436
  readonly additionalProperties: {
4379
4437
  readonly oneOf: readonly [{
@@ -4382,8 +4440,11 @@ export declare const scorecardConfigSchema: {
4382
4440
  readonly type: "object";
4383
4441
  }];
4384
4442
  };
4443
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4444
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4385
4445
  };
4386
4446
  readonly arazzo1Rules: {
4447
+ readonly nodeTypeName: undefined;
4387
4448
  readonly type: "object";
4388
4449
  readonly additionalProperties: {
4389
4450
  readonly oneOf: readonly [{
@@ -4392,8 +4453,11 @@ export declare const scorecardConfigSchema: {
4392
4453
  readonly type: "object";
4393
4454
  }];
4394
4455
  };
4456
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4457
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4395
4458
  };
4396
4459
  readonly overlay1Rules: {
4460
+ readonly nodeTypeName: undefined;
4397
4461
  readonly type: "object";
4398
4462
  readonly additionalProperties: {
4399
4463
  readonly oneOf: readonly [{
@@ -4402,8 +4466,11 @@ export declare const scorecardConfigSchema: {
4402
4466
  readonly type: "object";
4403
4467
  }];
4404
4468
  };
4469
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4470
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4405
4471
  };
4406
4472
  readonly openrpc1Rules: {
4473
+ readonly nodeTypeName: undefined;
4407
4474
  readonly type: "object";
4408
4475
  readonly additionalProperties: {
4409
4476
  readonly oneOf: readonly [{
@@ -4412,6 +4479,8 @@ export declare const scorecardConfigSchema: {
4412
4479
  readonly type: "object";
4413
4480
  }];
4414
4481
  };
4482
+ readonly description: "The rules configuration blocks set up linting rules and their severity. You can configure built-in rules, add configurable rules, and rules from plugins.";
4483
+ readonly documentationLink: "https://redocly.com/docs/cli/configuration/reference/rules#rules";
4415
4484
  };
4416
4485
  readonly name: {
4417
4486
  readonly type: "string";
@@ -4419,19 +4488,16 @@ export declare const scorecardConfigSchema: {
4419
4488
  readonly color: {
4420
4489
  readonly type: "string";
4421
4490
  };
4422
- readonly extends: {
4423
- readonly type: "array";
4424
- readonly items: {
4425
- readonly type: "string";
4426
- };
4427
- };
4428
4491
  };
4429
4492
  readonly additionalProperties: false;
4430
4493
  };
4431
4494
  };
4432
4495
  readonly targets: {
4496
+ readonly nodeTypeName: "ScorecardClassicTargetList";
4497
+ readonly description: "Provide custom `minimumLevel` for specific targets.";
4433
4498
  readonly type: "array";
4434
4499
  readonly items: {
4500
+ readonly nodeTypeName: "ScorecardClassicTarget";
4435
4501
  readonly type: "object";
4436
4502
  readonly required: readonly ["where"];
4437
4503
  readonly properties: {
@@ -4443,10 +4509,14 @@ export declare const scorecardConfigSchema: {
4443
4509
  readonly additionalProperties: true;
4444
4510
  };
4445
4511
  readonly where: {
4512
+ readonly nodeTypeName: "ScorecardClassicTargetWhere";
4513
+ readonly description: "Specify which API descriptions to apply the `minimumLevel` to based on the metadata.";
4514
+ readonly documentationLink: "https://redocly.com/docs/realm/config/scorecard-classic#where-object";
4446
4515
  readonly type: "object";
4447
4516
  readonly required: readonly ["metadata"];
4448
4517
  readonly properties: {
4449
4518
  readonly metadata: {
4519
+ readonly nodeTypeName: "ScorecardClassicTargetWhereMetadata";
4450
4520
  readonly type: "object";
4451
4521
  readonly additionalProperties: {
4452
4522
  readonly type: "string";
@@ -4,6 +4,7 @@ exports.scorecardConfigSchema = exports.catalogsConfigSchema = exports.catalogSc
4
4
  const redoc_config_schema_1 = require("./redoc-config-schema");
5
5
  const reference_docs_config_schema_1 = require("./reference-docs-config-schema");
6
6
  const common_1 = require("./common");
7
+ const config_1 = require("./constants/config");
7
8
  const hideConfigSchema = {
8
9
  type: 'object',
9
10
  properties: {
@@ -606,6 +607,9 @@ exports.catalogsConfigSchema = {
606
607
  },
607
608
  };
608
609
  exports.scorecardConfigSchema = {
610
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassic,
611
+ description: 'Add and create sets of rules and test your API description files against them. With these rules you can maintain quality across your existing APIs and ensure that newly-added or updated APIs match your criteria. An API scorecard can include multiple sets of rules, corresponding to different quality levels.',
612
+ documentationLink: 'https://redocly.com/docs/realm/config/scorecard-classic',
609
613
  type: 'object',
610
614
  additionalProperties: true,
611
615
  required: [],
@@ -615,6 +619,9 @@ exports.scorecardConfigSchema = {
615
619
  */
616
620
  ignoreNonCompliant: { type: 'boolean', default: false },
617
621
  teamMetadataProperty: {
622
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicTeamMetadataProperty,
623
+ description: 'Provide custom team label and team metadata property.',
624
+ documentationLink: 'https://redocly.com/docs/realm/config/scorecard-classic#team-metadata-object',
618
625
  type: 'object',
619
626
  properties: {
620
627
  property: { type: 'string' },
@@ -623,27 +630,41 @@ exports.scorecardConfigSchema = {
623
630
  },
624
631
  },
625
632
  levels: {
633
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicLevelList,
634
+ description: 'List of levels to score against.',
626
635
  type: 'array',
627
636
  items: {
637
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicLevel,
638
+ documentationLink: 'https://redocly.com/docs/realm/config/scorecard-classic#level-object',
628
639
  type: 'object',
629
640
  required: ['name'],
630
- properties: Object.assign(Object.assign(Object.assign({ name: { type: 'string' }, color: { type: 'string' }, extends: { type: 'array', items: { type: 'string' } } }, common_1.ruleSchemas), common_1.preprocessorSchemas), common_1.decoratorsSchemas),
641
+ properties: Object.assign({ name: { type: 'string' }, color: { type: 'string' } }, common_1.configGovernanceSchema),
631
642
  additionalProperties: false,
632
643
  },
633
644
  },
634
645
  targets: {
646
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicTargetList,
647
+ description: 'Provide custom `minimumLevel` for specific targets.',
635
648
  type: 'array',
636
649
  items: {
650
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicTarget,
637
651
  type: 'object',
638
652
  required: ['where'],
639
653
  properties: {
640
654
  minimumLevel: { type: 'string' },
641
655
  rules: { type: 'object', additionalProperties: true },
642
656
  where: {
657
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicTargetWhere,
658
+ description: 'Specify which API descriptions to apply the `minimumLevel` to based on the metadata.',
659
+ documentationLink: 'https://redocly.com/docs/realm/config/scorecard-classic#where-object',
643
660
  type: 'object',
644
661
  required: ['metadata'],
645
662
  properties: {
646
- metadata: { type: 'object', additionalProperties: { type: 'string' } },
663
+ metadata: {
664
+ nodeTypeName: config_1.CONFIG_NODE_TYPE_NAMES.ScorecardClassicTargetWhereMetadata,
665
+ type: 'object',
666
+ additionalProperties: { type: 'string' },
667
+ },
647
668
  },
648
669
  additionalProperties: false,
649
670
  },
package/lib/index.d.ts CHANGED
@@ -3,5 +3,7 @@ export { rbacConfigSchema, rootRedoclyConfigSchema } from './root-config-schema'
3
3
  export { redocConfigSchema } from './redoc-config-schema';
4
4
  export * from './types';
5
5
  export * from './common';
6
- export { ApigeeDevOnboardingIntegrationAuthType, AuthProviderType, DEFAULT_TEAM_CLAIM_NAME, LayoutVariant, REDOCLY_TEAMS_RBAC, REDOCLY_ROUTE_RBAC, ENTITY_RELATION_TYPES, NODE_TYPE_NAMES, } from './constants';
6
+ export { ApigeeDevOnboardingIntegrationAuthType, AuthProviderType, DEFAULT_TEAM_CLAIM_NAME, LayoutVariant, REDOCLY_TEAMS_RBAC, REDOCLY_ROUTE_RBAC, } from './constants/shared';
7
+ export { CONFIG_NODE_TYPE_NAMES } from './constants/config';
8
+ export { ENTITY_RELATION_TYPES, ENTITY_NODE_TYPE_NAMES } from './constants/entities';
7
9
  export * from './entities-catalog-entity-file-schema';
package/lib/index.js CHANGED
@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
- exports.NODE_TYPE_NAMES = exports.ENTITY_RELATION_TYPES = exports.REDOCLY_ROUTE_RBAC = exports.REDOCLY_TEAMS_RBAC = exports.LayoutVariant = exports.DEFAULT_TEAM_CLAIM_NAME = exports.AuthProviderType = exports.ApigeeDevOnboardingIntegrationAuthType = exports.redocConfigSchema = exports.rootRedoclyConfigSchema = exports.rbacConfigSchema = exports.productConfigOverrideSchema = exports.productThemeOverrideSchema = void 0;
17
+ exports.ENTITY_NODE_TYPE_NAMES = exports.ENTITY_RELATION_TYPES = exports.CONFIG_NODE_TYPE_NAMES = exports.REDOCLY_ROUTE_RBAC = exports.REDOCLY_TEAMS_RBAC = exports.LayoutVariant = exports.DEFAULT_TEAM_CLAIM_NAME = exports.AuthProviderType = exports.ApigeeDevOnboardingIntegrationAuthType = exports.redocConfigSchema = exports.rootRedoclyConfigSchema = exports.rbacConfigSchema = exports.productConfigOverrideSchema = exports.productThemeOverrideSchema = void 0;
18
18
  var product_override_schema_1 = require("./product-override-schema");
19
19
  Object.defineProperty(exports, "productThemeOverrideSchema", { enumerable: true, get: function () { return product_override_schema_1.productThemeOverrideSchema; } });
20
20
  Object.defineProperty(exports, "productConfigOverrideSchema", { enumerable: true, get: function () { return product_override_schema_1.productConfigOverrideSchema; } });
@@ -25,14 +25,17 @@ var redoc_config_schema_1 = require("./redoc-config-schema");
25
25
  Object.defineProperty(exports, "redocConfigSchema", { enumerable: true, get: function () { return redoc_config_schema_1.redocConfigSchema; } });
26
26
  __exportStar(require("./types"), exports);
27
27
  __exportStar(require("./common"), exports);
28
- var constants_1 = require("./constants");
29
- Object.defineProperty(exports, "ApigeeDevOnboardingIntegrationAuthType", { enumerable: true, get: function () { return constants_1.ApigeeDevOnboardingIntegrationAuthType; } });
30
- Object.defineProperty(exports, "AuthProviderType", { enumerable: true, get: function () { return constants_1.AuthProviderType; } });
31
- Object.defineProperty(exports, "DEFAULT_TEAM_CLAIM_NAME", { enumerable: true, get: function () { return constants_1.DEFAULT_TEAM_CLAIM_NAME; } });
32
- Object.defineProperty(exports, "LayoutVariant", { enumerable: true, get: function () { return constants_1.LayoutVariant; } });
33
- Object.defineProperty(exports, "REDOCLY_TEAMS_RBAC", { enumerable: true, get: function () { return constants_1.REDOCLY_TEAMS_RBAC; } });
34
- Object.defineProperty(exports, "REDOCLY_ROUTE_RBAC", { enumerable: true, get: function () { return constants_1.REDOCLY_ROUTE_RBAC; } });
35
- Object.defineProperty(exports, "ENTITY_RELATION_TYPES", { enumerable: true, get: function () { return constants_1.ENTITY_RELATION_TYPES; } });
36
- Object.defineProperty(exports, "NODE_TYPE_NAMES", { enumerable: true, get: function () { return constants_1.NODE_TYPE_NAMES; } });
28
+ var shared_1 = require("./constants/shared");
29
+ Object.defineProperty(exports, "ApigeeDevOnboardingIntegrationAuthType", { enumerable: true, get: function () { return shared_1.ApigeeDevOnboardingIntegrationAuthType; } });
30
+ Object.defineProperty(exports, "AuthProviderType", { enumerable: true, get: function () { return shared_1.AuthProviderType; } });
31
+ Object.defineProperty(exports, "DEFAULT_TEAM_CLAIM_NAME", { enumerable: true, get: function () { return shared_1.DEFAULT_TEAM_CLAIM_NAME; } });
32
+ Object.defineProperty(exports, "LayoutVariant", { enumerable: true, get: function () { return shared_1.LayoutVariant; } });
33
+ Object.defineProperty(exports, "REDOCLY_TEAMS_RBAC", { enumerable: true, get: function () { return shared_1.REDOCLY_TEAMS_RBAC; } });
34
+ Object.defineProperty(exports, "REDOCLY_ROUTE_RBAC", { enumerable: true, get: function () { return shared_1.REDOCLY_ROUTE_RBAC; } });
35
+ var config_1 = require("./constants/config");
36
+ Object.defineProperty(exports, "CONFIG_NODE_TYPE_NAMES", { enumerable: true, get: function () { return config_1.CONFIG_NODE_TYPE_NAMES; } });
37
+ var entities_1 = require("./constants/entities");
38
+ Object.defineProperty(exports, "ENTITY_RELATION_TYPES", { enumerable: true, get: function () { return entities_1.ENTITY_RELATION_TYPES; } });
39
+ Object.defineProperty(exports, "ENTITY_NODE_TYPE_NAMES", { enumerable: true, get: function () { return entities_1.ENTITY_NODE_TYPE_NAMES; } });
37
40
  __exportStar(require("./entities-catalog-entity-file-schema"), exports);
38
41
  //# sourceMappingURL=index.js.map