docs(json-schema): add constraints and installTools (#42834)

* docs(json-schema): add `constraints` and `installTools`

This requires `toolNames` and `additionalConstraintNames` are exported
for use.

* fixup! docs(json-schema): add `constraints` and `installTools`

Author: jamietanna

lib/util/exec/types.ts

@@ -6,7 +6,7 @@ import type { Options as ExecaOptions } from 'execa';
  *
  * TODO #41849 replace with upstream types
  */
-const toolNames = [
+export const toolNames = [
   'bazelisk',
   'bun',
   'bundler',
@@ -62,7 +62,7 @@ export function isToolName(value: unknown): value is ToolName {
 /**
  * Additional constraints that can be specified for some Managers, but are **not** tools that Containerbase supports.
  */
-const additionalConstraintNames = [
+export const additionalConstraintNames = [
   /**
    * Used in the `gomod` manager to specify the version of the Go toolchain to use.
    *

tools/docs/schema.ts

@@ -4,6 +4,10 @@ import type {
   RenovateRequiredOption,
 } from '../../lib/config/types.ts';
 import { pkg } from '../../lib/expose.ts';
+import {
+  additionalConstraintNames,
+  toolNames,
+} from '../../lib/util/exec/types.ts';
 import { hasKey } from '../../lib/util/object.ts';
 import { updateFile } from '../utils/index.ts';
 
@@ -122,6 +126,39 @@ function createSingleConfig(option: RenovateOptions): Record<string, unknown> {
   ) {
     temp.$ref = '#';
   }
+
+  if (option.name === 'constraints') {
+    temp.additionalProperties = false;
+    temp.properties = {};
+
+    for (const tool of [...toolNames]) {
+      temp.properties[tool] = {
+        type: 'string',
+        description: `A constraint for the \`${tool}\` Containerbase tool`,
+      };
+    }
+
+    for (const constraintName of [...additionalConstraintNames]) {
+      temp.properties[constraintName] = {
+        type: 'string',
+        description: `A constraint for \`${constraintName}\``,
+      };
+    }
+  }
+
+  if (option.name === 'installTools') {
+    temp.additionalProperties = false;
+    temp.properties = {};
+
+    for (const tool of [...toolNames]) {
+      temp.properties[tool] = {
+        type: 'object',
+        description: `Install the \`${tool}\` Containerbase tool`,
+        additionalProperties: false,
+      };
+    }
+  }
+
   return temp;
 }