@aws-cdk/cloud-assembly-schema 2.151.0 → 36.0.1

package/.jsii

@@ -9,14 +9,14 @@
   },
   "bundled": {
     "jsonschema": "^1.4.1",
-    "semver": "^7.6.2"
+    "semver": "^7.6.3"
   },
   "description": "Cloud Assembly Schema",
   "docs": {
     "stability": "stable"
   },
-  "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "5.4.25 (build 09cecf6)",
+  "homepage": "https://github.com/cdklabs/cloud-assembly-schema",
+  "jsiiVersion": "5.4.31 (build 9643ee9)",
   "keywords": [
     "aws",
     "cdk"
@@ -24,23 +24,19 @@
   "license": "Apache-2.0",
   "metadata": {
     "jsii": {
-      "compiledWithDeprecationWarnings": true,
       "pacmak": {
         "hasDefaultInterfaces": true
-      },
-      "rosetta": {
-        "strict": false
       }
-    }
+    },
+    "tscRootDir": "lib"
   },
   "name": "@aws-cdk/cloud-assembly-schema",
   "readme": {
-    "markdown": "# Cloud Assembly Schema\n\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.\n\n## Cloud Assembly\n\nThe *Cloud Assembly* is the output of the synthesis operation. It is produced as part of the\n[`cdk synth`](https://github.com/aws/aws-cdk/tree/main/packages/aws-cdk#cdk-synthesize)\ncommand, or the [`app.synth()`](https://github.com/aws/aws-cdk/blob/main/packages/@aws-cdk/core/lib/app.ts#L135) method invocation.\n\nIts essentially a set of files and directories, one of which is the `manifest.json` file. It defines the set of instructions that are\nneeded in order to deploy the assembly directory.\n\n> For example, when `cdk deploy` is executed, the CLI reads this file and performs its instructions:\n>\n> - Build container images.\n> - Upload assets.\n> - Deploy CloudFormation templates.\n\nTherefore, the assembly is how the CDK class library and CDK CLI (or any other consumer) communicate. To ensure compatibility\nbetween the assembly and its consumers, we treat the manifest file as a well defined, versioned schema.\n\n## Schema\n\nThis module contains the typescript structs that comprise the `manifest.json` file, as well as the\ngenerated [*json-schema*](./schema/cloud-assembly.schema.json).\n\n## Versioning\n\nThe schema version is specified in the [`cloud-assembly.version.json`](./schema/cloud-assembly.schema.json) file, under the `version` property.\nIt follows semantic versioning, but with a small twist.\n\nWhen we add instructions to the assembly, they are reflected in the manifest file and the *json-schema* accordingly.\nEvery such instruction, is crucial for ensuring the correct deployment behavior. This means that to properly deploy a cloud assembly,\nconsumers must be aware of every such instruction modification.\n\nFor this reason, every change to the schema, even though it might not strictly break validation of the *json-schema* format,\nis considered `major` version bump.\n\n## How to consume\n\nIf you'd like to consume the [schema file](./schema/cloud-assembly.schema.json) in order to do validations on `manifest.json` files,\nsimply download it from this repo and run it against standard *json-schema* validators, such as [jsonschema](https://www.npmjs.com/package/jsonschema).\n\nConsumers must take into account the `major` version of the schema they are consuming. They should reject cloud assemblies\nwith a `major` version that is higher than what they expect. While schema validation might pass on such assemblies, the deployment integrity\ncannot be guaranteed because some instructions will be ignored.\n\n> For example, if your consumer was built when the schema version was 2.0.0, you should reject deploying cloud assemblies with a\n> manifest version of 3.0.0.\n\n## Contributing\n\nSee [Contribution Guide](./CONTRIBUTING.md)\n"
+    "markdown": "# Cloud Assembly Schema\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.\n\n## Cloud Assembly\n\nThe _Cloud Assembly_ is the output of the synthesis operation. It is produced as part of the\n[`cdk synth`](https://github.com/aws/aws-cdk/tree/main/packages/aws-cdk#cdk-synthesize)\ncommand, or the [`app.synth()`](https://github.com/aws/aws-cdk/blob/main/packages/@aws-cdk/core/lib/app.ts#L135) method invocation.\n\nIts essentially a set of files and directories, one of which is the `manifest.json` file. It defines the set of instructions that are\nneeded in order to deploy the assembly directory.\n\n> For example, when `cdk deploy` is executed, the CLI reads this file and performs its instructions:\n>\n> - Build container images.\n> - Upload assets.\n> - Deploy CloudFormation templates.\n\nTherefore, the assembly is how the CDK class library and CDK CLI (or any other consumer) communicate. To ensure compatibility\nbetween the assembly and its consumers, we treat the manifest file as a well defined, versioned schema.\n\n## Schema\n\nThis module contains the typescript structs that comprise the `manifest.json` file, as well as the\ngenerated [_json-schema_](./schema/cloud-assembly.schema.json).\n\n## Versioning\n\nThe schema version is specified my the major version of the package release. It follows semantic versioning, but with a small twist.\n\nWhen we add instructions to the assembly, they are reflected in the manifest file and the _json-schema_ accordingly.\nEvery such instruction, is crucial for ensuring the correct deployment behavior. This means that to properly deploy a cloud assembly,\nconsumers must be aware of every such instruction modification.\n\nFor this reason, every change to the schema, even though it might not strictly break validation of the _json-schema_ format,\nis considered `major` version bump. All changes that do not impact the schema are considered a `minor` version bump.\n\n## How to consume\n\nIf you'd like to consume the [schema file](./schema/cloud-assembly.schema.json) in order to do validations on `manifest.json` files,\nsimply download it from this repo and run it against standard _json-schema_ validators, such as [jsonschema](https://www.npmjs.com/package/jsonschema).\n\nConsumers must take into account the `major` version of the schema they are consuming. They should reject cloud assemblies\nwith a `major` version that is higher than what they expect. While schema validation might pass on such assemblies, the deployment integrity\ncannot be guaranteed because some instructions will be ignored.\n\n> For example, if your consumer was built when the schema version was 2.0.0, you should reject deploying cloud assemblies with a\n> manifest version of 3.0.0.\n\n## Contributing\n\nSee [Contribution Guide](./CONTRIBUTING.md)\n"
   },
   "repository": {
-    "directory": "packages/@aws-cdk/cloud-assembly-schema",
     "type": "git",
-    "url": "https://github.com/aws/aws-cdk.git"
+    "url": "https://github.com/cdklabs/cloud-assembly-schema.git"
   },
   "schema": "jsii/0.10.0",
   "targets": {
@@ -49,6 +45,9 @@
       "namespace": "Amazon.CDK.CloudAssembly.Schema",
       "packageId": "Amazon.CDK.CloudAssembly.Schema"
     },
+    "go": {
+      "moduleName": "github.com/aws/aws-cdk-go/awscdk/cloudassemblyschema"
+    },
     "java": {
       "maven": {
         "artifactId": "cdk-cloud-assembly-schema",
@@ -74,11 +73,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to AMI context provider.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst amiContextQuery: cloud_assembly_schema.AmiContextQuery = {\n  account: 'account',\n  filters: {\n    filtersKey: ['filters'],\n  },\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  owners: ['owners'],\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query to AMI context provider."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AmiContextQuery",
       "kind": "interface",
@@ -195,11 +190,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A manifest for a single artifact within the cloud assembly.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst artifactManifest: cloud_assembly_schema.ArtifactManifest = {\n  type: cloud_assembly_schema.ArtifactType.NONE,\n\n  // the properties below are optional\n  dependencies: ['dependencies'],\n  displayName: 'displayName',\n  environment: 'environment',\n  metadata: {\n    metadataKey: [{\n      type: 'type',\n\n      // the properties below are optional\n      data: 'data',\n      trace: ['trace'],\n    }],\n  },\n  properties: {\n    templateFile: 'templateFile',\n\n    // the properties below are optional\n    assumeRoleArn: 'assumeRoleArn',\n    assumeRoleExternalId: 'assumeRoleExternalId',\n    bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n    cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n    lookupRole: {\n      arn: 'arn',\n\n      // the properties below are optional\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n      requiresBootstrapStackVersion: 123,\n    },\n    parameters: {\n      parametersKey: 'parameters',\n    },\n    requiresBootstrapStackVersion: 123,\n    stackName: 'stackName',\n    stackTemplateAssetObjectUrl: 'stackTemplateAssetObjectUrl',\n    tags: {\n      tagsKey: 'tags',\n    },\n    terminationProtection: false,\n    validateOnSynth: false,\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "A manifest for a single artifact within the cloud assembly."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ArtifactManifest",
       "kind": "interface",
@@ -359,7 +350,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/cloud-assembly/metadata-schema.ts",
-        "line": 271
+        "line": 275
       },
       "members": [
         {
@@ -465,11 +456,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A manifest which describes the cloud assembly.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst assemblyManifest: cloud_assembly_schema.AssemblyManifest = {\n  version: 'version',\n\n  // the properties below are optional\n  artifacts: {\n    artifactsKey: {\n      type: cloud_assembly_schema.ArtifactType.NONE,\n\n      // the properties below are optional\n      dependencies: ['dependencies'],\n      displayName: 'displayName',\n      environment: 'environment',\n      metadata: {\n        metadataKey: [{\n          type: 'type',\n\n          // the properties below are optional\n          data: 'data',\n          trace: ['trace'],\n        }],\n      },\n      properties: {\n        templateFile: 'templateFile',\n\n        // the properties below are optional\n        assumeRoleArn: 'assumeRoleArn',\n        assumeRoleExternalId: 'assumeRoleExternalId',\n        bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n        cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n        lookupRole: {\n          arn: 'arn',\n\n          // the properties below are optional\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n          requiresBootstrapStackVersion: 123,\n        },\n        parameters: {\n          parametersKey: 'parameters',\n        },\n        requiresBootstrapStackVersion: 123,\n        stackName: 'stackName',\n        stackTemplateAssetObjectUrl: 'stackTemplateAssetObjectUrl',\n        tags: {\n          tagsKey: 'tags',\n        },\n        terminationProtection: false,\n        validateOnSynth: false,\n      },\n    },\n  },\n  missing: [{\n    key: 'key',\n    props: {\n      account: 'account',\n      filters: {\n        filtersKey: ['filters'],\n      },\n      region: 'region',\n\n      // the properties below are optional\n      lookupRoleArn: 'lookupRoleArn',\n      owners: ['owners'],\n    },\n    provider: cloud_assembly_schema.ContextProvider.AMI_PROVIDER,\n  }],\n  runtime: {\n    libraries: {\n      librariesKey: 'libraries',\n    },\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "A manifest which describes the cloud assembly."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssemblyManifest",
       "kind": "interface",
@@ -568,11 +555,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Definitions for the asset manifest.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst assetManifest: cloud_assembly_schema.AssetManifest = {\n  version: 'version',\n\n  // the properties below are optional\n  dockerImages: {\n    dockerImagesKey: {\n      destinations: {\n        destinationsKey: {\n          imageTag: 'imageTag',\n          repositoryName: 'repositoryName',\n\n          // the properties below are optional\n          assumeRoleArn: 'assumeRoleArn',\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          region: 'region',\n        },\n      },\n      source: {\n        cacheDisabled: false,\n        cacheFrom: [{\n          type: 'type',\n\n          // the properties below are optional\n          params: {\n            paramsKey: 'params',\n          },\n        }],\n        cacheTo: {\n          type: 'type',\n\n          // the properties below are optional\n          params: {\n            paramsKey: 'params',\n          },\n        },\n        directory: 'directory',\n        dockerBuildArgs: {\n          dockerBuildArgsKey: 'dockerBuildArgs',\n        },\n        dockerBuildSecrets: {\n          dockerBuildSecretsKey: 'dockerBuildSecrets',\n        },\n        dockerBuildSsh: 'dockerBuildSsh',\n        dockerBuildTarget: 'dockerBuildTarget',\n        dockerFile: 'dockerFile',\n        dockerOutputs: ['dockerOutputs'],\n        executable: ['executable'],\n        networkMode: 'networkMode',\n        platform: 'platform',\n      },\n    },\n  },\n  files: {\n    filesKey: {\n      destinations: {\n        destinationsKey: {\n          bucketName: 'bucketName',\n          objectKey: 'objectKey',\n\n          // the properties below are optional\n          assumeRoleArn: 'assumeRoleArn',\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          region: 'region',\n        },\n      },\n      source: {\n        executable: ['executable'],\n        packaging: cloud_assembly_schema.FileAssetPackaging.FILE,\n        path: 'path',\n      },\n    },\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Definitions for the asset manifest."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifest",
       "kind": "interface",
@@ -652,17 +635,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Configuration options for the Asset Manifest.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst assetManifestOptions: cloud_assembly_schema.AssetManifestOptions = {\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  requiresBootstrapStackVersion: 123,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Configuration options for the Asset Manifest."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifestOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 139
+        "line": 138
       },
       "name": "AssetManifestOptions",
       "properties": [
@@ -677,7 +656,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 158
+            "line": 157
           },
           "name": "bootstrapStackVersionSsmParameter",
           "optional": true,
@@ -695,7 +674,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 145
+            "line": 144
           },
           "name": "requiresBootstrapStackVersion",
           "optional": true,
@@ -711,11 +690,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for the Asset Manifest.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst assetManifestProperties: cloud_assembly_schema.AssetManifestProperties = {\n  file: 'file',\n\n  // the properties below are optional\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  requiresBootstrapStackVersion: 123,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Artifact properties for the Asset Manifest."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifestProperties",
       "interfaces": [
@@ -724,7 +699,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 164
+        "line": 163
       },
       "name": "AssetManifestProperties",
       "properties": [
@@ -737,7 +712,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 168
+            "line": 167
           },
           "name": "file",
           "type": {
@@ -752,11 +727,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to availability zone context provider.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst availabilityZonesContextQuery: cloud_assembly_schema.AvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query to availability zone context provider."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AvailabilityZonesContextQuery",
       "kind": "interface",
@@ -824,17 +795,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for CloudFormation stacks.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst awsCloudFormationStackProperties: cloud_assembly_schema.AwsCloudFormationStackProperties = {\n  templateFile: 'templateFile',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n  lookupRole: {\n    arn: 'arn',\n\n    // the properties below are optional\n    assumeRoleExternalId: 'assumeRoleExternalId',\n    bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n    requiresBootstrapStackVersion: 123,\n  },\n  parameters: {\n    parametersKey: 'parameters',\n  },\n  requiresBootstrapStackVersion: 123,\n  stackName: 'stackName',\n  stackTemplateAssetObjectUrl: 'stackTemplateAssetObjectUrl',\n  tags: {\n    tagsKey: 'tags',\n  },\n  terminationProtection: false,\n  validateOnSynth: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Artifact properties for CloudFormation stacks."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AwsCloudFormationStackProperties",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 38
+        "line": 37
       },
       "name": "AwsCloudFormationStackProperties",
       "properties": [
@@ -847,7 +814,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 42
+            "line": 41
           },
           "name": "templateFile",
           "type": {
@@ -864,7 +831,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 76
+            "line": 75
           },
           "name": "assumeRoleArn",
           "optional": true,
@@ -882,7 +849,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 83
+            "line": 82
           },
           "name": "assumeRoleExternalId",
           "optional": true,
@@ -901,7 +868,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 126
+            "line": 125
           },
           "name": "bootstrapStackVersionSsmParameter",
           "optional": true,
@@ -919,7 +886,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 90
+            "line": 89
           },
           "name": "cloudFormationExecutionRoleArn",
           "optional": true,
@@ -937,7 +904,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 97
+            "line": 96
           },
           "name": "lookupRole",
           "optional": true,
@@ -955,7 +922,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 49
+            "line": 48
           },
           "name": "parameters",
           "optional": true,
@@ -978,7 +945,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 111
+            "line": 110
           },
           "name": "requiresBootstrapStackVersion",
           "optional": true,
@@ -996,7 +963,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 62
+            "line": 61
           },
           "name": "stackName",
           "optional": true,
@@ -1014,7 +981,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 104
+            "line": 103
           },
           "name": "stackTemplateAssetObjectUrl",
           "optional": true,
@@ -1032,7 +999,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 56
+            "line": 55
           },
           "name": "tags",
           "optional": true,
@@ -1055,7 +1022,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 69
+            "line": 68
           },
           "name": "terminationProtection",
           "optional": true,
@@ -1073,7 +1040,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 133
+            "line": 132
           },
           "name": "validateOnSynth",
           "optional": true,
@@ -1089,11 +1056,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Destination for assets that need to be uploaded to AWS.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst awsDestination: cloud_assembly_schema.AwsDestination = {\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Destination for assets that need to be uploaded to AWS."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AwsDestination",
       "kind": "interface",
@@ -1165,17 +1128,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Information needed to access an IAM role created as part of the bootstrap process.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst bootstrapRole: cloud_assembly_schema.BootstrapRole = {\n  arn: 'arn',\n\n  // the properties below are optional\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  requiresBootstrapStackVersion: 123,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Information needed to access an IAM role created as part of the bootstrap process."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.BootstrapRole",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 6
+        "line": 5
       },
       "name": "BootstrapRole",
       "properties": [
@@ -1188,7 +1147,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 11
+            "line": 10
           },
           "name": "arn",
           "type": {
@@ -1205,7 +1164,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 18
+            "line": 17
           },
           "name": "assumeRoleExternalId",
           "optional": true,
@@ -1223,7 +1182,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 32
+            "line": 31
           },
           "name": "bootstrapStackVersionSsmParameter",
           "optional": true,
@@ -1241,7 +1200,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 25
+            "line": 24
           },
           "name": "requiresBootstrapStackVersion",
           "optional": true,
@@ -1257,11 +1216,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk command i.e. `synth`, `deploy`, & `destroy`.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst cdkCommand: cloud_assembly_schema.CdkCommand = {\n  enabled: false,\n  expectedMessage: 'expectedMessage',\n  expectError: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Represents a cdk command i.e. `synth`, `deploy`, & `destroy`."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.CdkCommand",
       "kind": "interface",
@@ -1333,11 +1288,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for specific cdk commands that are run as part of the integration test workflow.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst cdkCommands: cloud_assembly_schema.CdkCommands = {\n  deploy: {\n    args: {\n      all: false,\n      app: 'app',\n      assetMetadata: false,\n      caBundlePath: 'caBundlePath',\n      changeSetName: 'changeSetName',\n      ci: false,\n      color: false,\n      concurrency: 123,\n      context: {\n        contextKey: 'context',\n      },\n      debug: false,\n      ec2Creds: false,\n      exclusively: false,\n      execute: false,\n      force: false,\n      ignoreErrors: false,\n      json: false,\n      lookups: false,\n      notices: false,\n      notificationArns: ['notificationArns'],\n      output: 'output',\n      outputsFile: 'outputsFile',\n      parameters: {\n        parametersKey: 'parameters',\n      },\n      pathMetadata: false,\n      profile: 'profile',\n      proxy: 'proxy',\n      requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n      reuseAssets: ['reuseAssets'],\n      roleArn: 'roleArn',\n      rollback: false,\n      stacks: ['stacks'],\n      staging: false,\n      strict: false,\n      toolkitStackName: 'toolkitStackName',\n      trace: false,\n      usePreviousParameters: false,\n      verbose: false,\n      versionReporting: false,\n    },\n    enabled: false,\n    expectedMessage: 'expectedMessage',\n    expectError: false,\n  },\n  destroy: {\n    args: {\n      all: false,\n      app: 'app',\n      assetMetadata: false,\n      caBundlePath: 'caBundlePath',\n      color: false,\n      context: {\n        contextKey: 'context',\n      },\n      debug: false,\n      ec2Creds: false,\n      exclusively: false,\n      force: false,\n      ignoreErrors: false,\n      json: false,\n      lookups: false,\n      notices: false,\n      output: 'output',\n      pathMetadata: false,\n      profile: 'profile',\n      proxy: 'proxy',\n      roleArn: 'roleArn',\n      stacks: ['stacks'],\n      staging: false,\n      strict: false,\n      trace: false,\n      verbose: false,\n      versionReporting: false,\n    },\n    enabled: false,\n    expectedMessage: 'expectedMessage',\n    expectError: false,\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options for specific cdk commands that are run as part of the integration test workflow."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.CdkCommands",
       "kind": "interface",
@@ -1391,11 +1342,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for configuring the Docker cache backend.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst containerImageAssetCacheOption: cloud_assembly_schema.ContainerImageAssetCacheOption = {\n  type: 'type',\n\n  // the properties below are optional\n  params: {\n    paramsKey: 'params',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options for configuring the Docker cache backend."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ContainerImageAssetCacheOption",
       "kind": "interface",
@@ -1913,11 +1860,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Default CDK CLI options that apply to all commands.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst defaultCdkOptions: cloud_assembly_schema.DefaultCdkOptions = {\n  all: false,\n  app: 'app',\n  assetMetadata: false,\n  caBundlePath: 'caBundlePath',\n  color: false,\n  context: {\n    contextKey: 'context',\n  },\n  debug: false,\n  ec2Creds: false,\n  ignoreErrors: false,\n  json: false,\n  lookups: false,\n  notices: false,\n  output: 'output',\n  pathMetadata: false,\n  profile: 'profile',\n  proxy: 'proxy',\n  roleArn: 'roleArn',\n  stacks: ['stacks'],\n  staging: false,\n  strict: false,\n  trace: false,\n  verbose: false,\n  versionReporting: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Default CDK CLI options that apply to all commands."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DefaultCdkOptions",
       "kind": "interface",
@@ -2364,11 +2307,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk deploy command.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst deployCommand: cloud_assembly_schema.DeployCommand = {\n  args: {\n    all: false,\n    app: 'app',\n    assetMetadata: false,\n    caBundlePath: 'caBundlePath',\n    changeSetName: 'changeSetName',\n    ci: false,\n    color: false,\n    concurrency: 123,\n    context: {\n      contextKey: 'context',\n    },\n    debug: false,\n    ec2Creds: false,\n    exclusively: false,\n    execute: false,\n    force: false,\n    ignoreErrors: false,\n    json: false,\n    lookups: false,\n    notices: false,\n    notificationArns: ['notificationArns'],\n    output: 'output',\n    outputsFile: 'outputsFile',\n    parameters: {\n      parametersKey: 'parameters',\n    },\n    pathMetadata: false,\n    profile: 'profile',\n    proxy: 'proxy',\n    requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n    reuseAssets: ['reuseAssets'],\n    roleArn: 'roleArn',\n    rollback: false,\n    stacks: ['stacks'],\n    staging: false,\n    strict: false,\n    toolkitStackName: 'toolkitStackName',\n    trace: false,\n    usePreviousParameters: false,\n    verbose: false,\n    versionReporting: false,\n  },\n  enabled: false,\n  expectedMessage: 'expectedMessage',\n  expectError: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Represents a cdk deploy command."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DeployCommand",
       "interfaces": [
@@ -2407,11 +2346,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options to use with cdk deploy.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst deployOptions: cloud_assembly_schema.DeployOptions = {\n  all: false,\n  app: 'app',\n  assetMetadata: false,\n  caBundlePath: 'caBundlePath',\n  changeSetName: 'changeSetName',\n  ci: false,\n  color: false,\n  concurrency: 123,\n  context: {\n    contextKey: 'context',\n  },\n  debug: false,\n  ec2Creds: false,\n  exclusively: false,\n  execute: false,\n  force: false,\n  ignoreErrors: false,\n  json: false,\n  lookups: false,\n  notices: false,\n  notificationArns: ['notificationArns'],\n  output: 'output',\n  outputsFile: 'outputsFile',\n  parameters: {\n    parametersKey: 'parameters',\n  },\n  pathMetadata: false,\n  profile: 'profile',\n  proxy: 'proxy',\n  requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n  reuseAssets: ['reuseAssets'],\n  roleArn: 'roleArn',\n  rollback: false,\n  stacks: ['stacks'],\n  staging: false,\n  strict: false,\n  toolkitStackName: 'toolkitStackName',\n  trace: false,\n  usePreviousParameters: false,\n  verbose: false,\n  versionReporting: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options to use with cdk deploy."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DeployOptions",
       "interfaces": [
@@ -2701,11 +2636,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk destroy command.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst destroyCommand: cloud_assembly_schema.DestroyCommand = {\n  args: {\n    all: false,\n    app: 'app',\n    assetMetadata: false,\n    caBundlePath: 'caBundlePath',\n    color: false,\n    context: {\n      contextKey: 'context',\n    },\n    debug: false,\n    ec2Creds: false,\n    exclusively: false,\n    force: false,\n    ignoreErrors: false,\n    json: false,\n    lookups: false,\n    notices: false,\n    output: 'output',\n    pathMetadata: false,\n    profile: 'profile',\n    proxy: 'proxy',\n    roleArn: 'roleArn',\n    stacks: ['stacks'],\n    staging: false,\n    strict: false,\n    trace: false,\n    verbose: false,\n    versionReporting: false,\n  },\n  enabled: false,\n  expectedMessage: 'expectedMessage',\n  expectError: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Represents a cdk destroy command."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DestroyCommand",
       "interfaces": [
@@ -2744,11 +2675,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options to use with cdk destroy.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst destroyOptions: cloud_assembly_schema.DestroyOptions = {\n  all: false,\n  app: 'app',\n  assetMetadata: false,\n  caBundlePath: 'caBundlePath',\n  color: false,\n  context: {\n    contextKey: 'context',\n  },\n  debug: false,\n  ec2Creds: false,\n  exclusively: false,\n  force: false,\n  ignoreErrors: false,\n  json: false,\n  lookups: false,\n  notices: false,\n  output: 'output',\n  pathMetadata: false,\n  profile: 'profile',\n  proxy: 'proxy',\n  roleArn: 'roleArn',\n  stacks: ['stacks'],\n  staging: false,\n  strict: false,\n  trace: false,\n  verbose: false,\n  versionReporting: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options to use with cdk destroy."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DestroyOptions",
       "interfaces": [
@@ -2805,11 +2732,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for configuring the Docker cache backend.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst dockerCacheOption: cloud_assembly_schema.DockerCacheOption = {\n  type: 'type',\n\n  // the properties below are optional\n  params: {\n    paramsKey: 'params',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options for configuring the Docker cache backend."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerCacheOption",
       "kind": "interface",
@@ -2871,11 +2794,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A file asset.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst dockerImageAsset: cloud_assembly_schema.DockerImageAsset = {\n  destinations: {\n    destinationsKey: {\n      imageTag: 'imageTag',\n      repositoryName: 'repositoryName',\n\n      // the properties below are optional\n      assumeRoleArn: 'assumeRoleArn',\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      region: 'region',\n    },\n  },\n  source: {\n    cacheDisabled: false,\n    cacheFrom: [{\n      type: 'type',\n\n      // the properties below are optional\n      params: {\n        paramsKey: 'params',\n      },\n    }],\n    cacheTo: {\n      type: 'type',\n\n      // the properties below are optional\n      params: {\n        paramsKey: 'params',\n      },\n    },\n    directory: 'directory',\n    dockerBuildArgs: {\n      dockerBuildArgsKey: 'dockerBuildArgs',\n    },\n    dockerBuildSecrets: {\n      dockerBuildSecretsKey: 'dockerBuildSecrets',\n    },\n    dockerBuildSsh: 'dockerBuildSsh',\n    dockerBuildTarget: 'dockerBuildTarget',\n    dockerFile: 'dockerFile',\n    dockerOutputs: ['dockerOutputs'],\n    executable: ['executable'],\n    networkMode: 'networkMode',\n    platform: 'platform',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "A file asset."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageAsset",
       "kind": "interface",
@@ -2930,11 +2849,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Where to publish docker images.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst dockerImageDestination: cloud_assembly_schema.DockerImageDestination = {\n  imageTag: 'imageTag',\n  repositoryName: 'repositoryName',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Where to publish docker images."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageDestination",
       "interfaces": [
@@ -2987,11 +2902,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Properties for how to produce a Docker image from a source.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst dockerImageSource: cloud_assembly_schema.DockerImageSource = {\n  cacheDisabled: false,\n  cacheFrom: [{\n    type: 'type',\n\n    // the properties below are optional\n    params: {\n      paramsKey: 'params',\n    },\n  }],\n  cacheTo: {\n    type: 'type',\n\n    // the properties below are optional\n    params: {\n      paramsKey: 'params',\n    },\n  },\n  directory: 'directory',\n  dockerBuildArgs: {\n    dockerBuildArgsKey: 'dockerBuildArgs',\n  },\n  dockerBuildSecrets: {\n    dockerBuildSecretsKey: 'dockerBuildSecrets',\n  },\n  dockerBuildSsh: 'dockerBuildSsh',\n  dockerBuildTarget: 'dockerBuildTarget',\n  dockerFile: 'dockerFile',\n  dockerOutputs: ['dockerOutputs'],\n  executable: ['executable'],\n  networkMode: 'networkMode',\n  platform: 'platform',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Properties for how to produce a Docker image from a source."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageSource",
       "kind": "interface",
@@ -3279,17 +3190,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to endpoint service context provider.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst endpointServiceAvailabilityZonesContextQuery: cloud_assembly_schema.EndpointServiceAvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n  serviceName: 'serviceName',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query to endpoint service context provider."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.EndpointServiceAvailabilityZonesContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 253
+        "line": 252
       },
       "name": "EndpointServiceAvailabilityZonesContextQuery",
       "properties": [
@@ -3302,7 +3209,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 257
+            "line": 256
           },
           "name": "account",
           "type": {
@@ -3318,7 +3225,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 262
+            "line": 261
           },
           "name": "region",
           "type": {
@@ -3334,7 +3241,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 274
+            "line": 273
           },
           "name": "serviceName",
           "type": {
@@ -3351,7 +3258,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 269
+            "line": 268
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -3367,11 +3274,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A file asset.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst fileAsset: cloud_assembly_schema.FileAsset = {\n  destinations: {\n    destinationsKey: {\n      bucketName: 'bucketName',\n      objectKey: 'objectKey',\n\n      // the properties below are optional\n      assumeRoleArn: 'assumeRoleArn',\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      region: 'region',\n    },\n  },\n  source: {\n    executable: ['executable'],\n    packaging: cloud_assembly_schema.FileAssetPackaging.FILE,\n    path: 'path',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "A file asset."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileAsset",
       "kind": "interface",
@@ -3588,11 +3491,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Where in S3 a file asset needs to be published.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst fileDestination: cloud_assembly_schema.FileDestination = {\n  bucketName: 'bucketName',\n  objectKey: 'objectKey',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Where in S3 a file asset needs to be published."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileDestination",
       "interfaces": [
@@ -3645,11 +3544,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Describe the source of a file asset.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst fileSource: cloud_assembly_schema.FileSource = {\n  executable: ['executable'],\n  packaging: cloud_assembly_schema.FileAssetPackaging.FILE,\n  path: 'path',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Describe the source of a file asset."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileSource",
       "kind": "interface",
@@ -3728,11 +3623,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Commands to run at predefined points during the integration test workflow.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst hooks: cloud_assembly_schema.Hooks = {\n  postDeploy: ['postDeploy'],\n  postDestroy: ['postDestroy'],\n  preDeploy: ['preDeploy'],\n  preDestroy: ['preDestroy'],\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Commands to run at predefined points during the integration test workflow."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.Hooks",
       "kind": "interface",
@@ -3842,17 +3733,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to hosted zone context provider.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst hostedZoneContextQuery: cloud_assembly_schema.HostedZoneContextQuery = {\n  account: 'account',\n  domainName: 'domainName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  privateZone: false,\n  vpcId: 'vpcId',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query to hosted zone context provider."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.HostedZoneContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 123
+        "line": 122
       },
       "name": "HostedZoneContextQuery",
       "properties": [
@@ -3865,7 +3752,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 127
+            "line": 126
           },
           "name": "account",
           "type": {
@@ -3881,7 +3768,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 144
+            "line": 143
           },
           "name": "domainName",
           "type": {
@@ -3897,7 +3784,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 132
+            "line": 131
           },
           "name": "region",
           "type": {
@@ -3914,7 +3801,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 139
+            "line": 138
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -3932,7 +3819,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 151
+            "line": 150
           },
           "name": "privateZone",
           "optional": true,
@@ -3951,7 +3838,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 161
+            "line": 160
           },
           "name": "vpcId",
           "optional": true,
@@ -3967,11 +3854,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Definitions for the integration testing manifest.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst integManifest: cloud_assembly_schema.IntegManifest = {\n  testCases: {\n    testCasesKey: {\n      stacks: ['stacks'],\n\n      // the properties below are optional\n      allowDestroy: ['allowDestroy'],\n      assertionStack: 'assertionStack',\n      assertionStackName: 'assertionStackName',\n      cdkCommandOptions: {\n        deploy: {\n          args: {\n            all: false,\n            app: 'app',\n            assetMetadata: false,\n            caBundlePath: 'caBundlePath',\n            changeSetName: 'changeSetName',\n            ci: false,\n            color: false,\n            concurrency: 123,\n            context: {\n              contextKey: 'context',\n            },\n            debug: false,\n            ec2Creds: false,\n            exclusively: false,\n            execute: false,\n            force: false,\n            ignoreErrors: false,\n            json: false,\n            lookups: false,\n            notices: false,\n            notificationArns: ['notificationArns'],\n            output: 'output',\n            outputsFile: 'outputsFile',\n            parameters: {\n              parametersKey: 'parameters',\n            },\n            pathMetadata: false,\n            profile: 'profile',\n            proxy: 'proxy',\n            requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n            reuseAssets: ['reuseAssets'],\n            roleArn: 'roleArn',\n            rollback: false,\n            stacks: ['stacks'],\n            staging: false,\n            strict: false,\n            toolkitStackName: 'toolkitStackName',\n            trace: false,\n            usePreviousParameters: false,\n            verbose: false,\n            versionReporting: false,\n          },\n          enabled: false,\n          expectedMessage: 'expectedMessage',\n          expectError: false,\n        },\n        destroy: {\n          args: {\n            all: false,\n            app: 'app',\n            assetMetadata: false,\n            caBundlePath: 'caBundlePath',\n            color: false,\n            context: {\n              contextKey: 'context',\n            },\n            debug: false,\n            ec2Creds: false,\n            exclusively: false,\n            force: false,\n            ignoreErrors: false,\n            json: false,\n            lookups: false,\n            notices: false,\n            output: 'output',\n            pathMetadata: false,\n            profile: 'profile',\n            proxy: 'proxy',\n            roleArn: 'roleArn',\n            stacks: ['stacks'],\n            staging: false,\n            strict: false,\n            trace: false,\n            verbose: false,\n            versionReporting: false,\n          },\n          enabled: false,\n          expectedMessage: 'expectedMessage',\n          expectError: false,\n        },\n      },\n      diffAssets: false,\n      hooks: {\n        postDeploy: ['postDeploy'],\n        postDestroy: ['postDestroy'],\n        preDeploy: ['preDeploy'],\n        preDestroy: ['preDestroy'],\n      },\n      regions: ['regions'],\n      stackUpdateWorkflow: false,\n    },\n  },\n  version: 'version',\n\n  // the properties below are optional\n  enableLookups: false,\n  synthContext: {\n    synthContextKey: 'synthContext',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Definitions for the integration testing manifest."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.IntegManifest",
       "kind": "interface",
@@ -4069,17 +3952,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a KMS Key.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst keyContextQuery: cloud_assembly_schema.KeyContextQuery = {\n  account: 'account',\n  aliasName: 'aliasName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for looking up a KMS Key."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.KeyContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 457
+        "line": 456
       },
       "name": "KeyContextQuery",
       "properties": [
@@ -4092,7 +3971,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 461
+            "line": 460
           },
           "name": "account",
           "type": {
@@ -4108,7 +3987,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 478
+            "line": 477
           },
           "name": "aliasName",
           "type": {
@@ -4124,7 +4003,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 466
+            "line": 465
           },
           "name": "region",
           "type": {
@@ -4141,7 +4020,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 473
+            "line": 472
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -4157,11 +4036,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a load balancer.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst loadBalancerContextQuery: cloud_assembly_schema.LoadBalancerContextQuery = {\n  account: 'account',\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n  region: 'region',\n\n  // the properties below are optional\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for looking up a load balancer."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerContextQuery",
       "interfaces": [
@@ -4170,7 +4045,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 317
+        "line": 316
       },
       "name": "LoadBalancerContextQuery",
       "properties": [
@@ -4183,7 +4058,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 321
+            "line": 320
           },
           "name": "account",
           "type": {
@@ -4199,7 +4074,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 326
+            "line": 325
           },
           "name": "region",
           "type": {
@@ -4216,7 +4091,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 333
+            "line": 332
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -4232,17 +4107,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Filters for selecting load balancers.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst loadBalancerFilter: cloud_assembly_schema.LoadBalancerFilter = {\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n\n  // the properties below are optional\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Filters for selecting load balancers."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerFilter",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 295
+        "line": 294
       },
       "name": "LoadBalancerFilter",
       "properties": [
@@ -4255,7 +4126,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 299
+            "line": 298
           },
           "name": "loadBalancerType",
           "type": {
@@ -4272,7 +4143,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 305
+            "line": 304
           },
           "name": "loadBalancerArn",
           "optional": true,
@@ -4290,7 +4161,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 311
+            "line": 310
           },
           "name": "loadBalancerTags",
           "optional": true,
@@ -4311,11 +4182,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a load balancer listener.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst loadBalancerListenerContextQuery: cloud_assembly_schema.LoadBalancerListenerContextQuery = {\n  account: 'account',\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n  region: 'region',\n\n  // the properties below are optional\n  listenerArn: 'listenerArn',\n  listenerPort: 123,\n  listenerProtocol: cloud_assembly_schema.LoadBalancerListenerProtocol.HTTP,\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for looking up a load balancer listener."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerListenerContextQuery",
       "interfaces": [
@@ -4324,7 +4191,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 374
+        "line": 373
       },
       "name": "LoadBalancerListenerContextQuery",
       "properties": [
@@ -4337,7 +4204,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 378
+            "line": 377
           },
           "name": "account",
           "type": {
@@ -4353,7 +4220,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 383
+            "line": 382
           },
           "name": "region",
           "type": {
@@ -4370,7 +4237,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 396
+            "line": 395
           },
           "name": "listenerArn",
           "optional": true,
@@ -4388,7 +4255,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 408
+            "line": 407
           },
           "name": "listenerPort",
           "optional": true,
@@ -4406,7 +4273,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 402
+            "line": 401
           },
           "name": "listenerProtocol",
           "optional": true,
@@ -4424,7 +4291,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 390
+            "line": 389
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -4445,7 +4312,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 339
+        "line": 338
       },
       "members": [
         {
@@ -4504,7 +4371,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 280
+        "line": 279
       },
       "members": [
         {
@@ -4530,11 +4397,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for the loadManifest operation.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst loadManifestOptions: cloud_assembly_schema.LoadManifestOptions = {\n  skipEnumCheck: false,\n  skipVersionCheck: false,\n  topoSort: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Options for the loadManifest operation."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadManifestOptions",
       "kind": "interface",
@@ -4625,7 +4488,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 141
+            "line": 146
           },
           "name": "load",
           "parameters": [
@@ -4685,7 +4548,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 101
+            "line": 104
           },
           "name": "loadAssetManifest",
           "parameters": [
@@ -4713,7 +4576,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 120
+            "line": 123
           },
           "name": "loadIntegManifest",
           "parameters": [
@@ -4742,7 +4605,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 135
+            "line": 138
           },
           "name": "save",
           "parameters": [
@@ -4800,7 +4663,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 92
+            "line": 95
           },
           "name": "saveAssetManifest",
           "parameters": [
@@ -4832,7 +4695,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 111
+            "line": 114
           },
           "name": "saveIntegManifest",
           "parameters": [
@@ -4864,7 +4727,7 @@
           },
           "locationInModule": {
             "filename": "lib/manifest.ts",
-            "line": 127
+            "line": 130
           },
           "name": "version",
           "returns": {
@@ -4883,17 +4746,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A metadata entry in a cloud assembly artifact.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst metadataEntry: cloud_assembly_schema.MetadataEntry = {\n  type: 'type',\n\n  // the properties below are optional\n  data: 'data',\n  trace: ['trace'],\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "A metadata entry in a cloud assembly artifact."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.MetadataEntry",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/metadata-schema.ts",
-        "line": 306
+        "line": 310
       },
       "name": "MetadataEntry",
       "properties": [
@@ -4906,7 +4765,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 310
+            "line": 314
           },
           "name": "type",
           "type": {
@@ -4923,7 +4782,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 317
+            "line": 321
           },
           "name": "data",
           "optional": true,
@@ -4961,7 +4820,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 324
+            "line": 328
           },
           "name": "trace",
           "optional": true,
@@ -4982,11 +4841,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a missing piece of context.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst missingContext: cloud_assembly_schema.MissingContext = {\n  key: 'key',\n  props: {\n    account: 'account',\n    filters: {\n      filtersKey: ['filters'],\n    },\n    region: 'region',\n\n    // the properties below are optional\n    lookupRoleArn: 'lookupRoleArn',\n    owners: ['owners'],\n  },\n  provider: cloud_assembly_schema.ContextProvider.AMI_PROVIDER,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Represents a missing piece of context."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.MissingContext",
       "kind": "interface",
@@ -5088,17 +4943,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for nested cloud assemblies.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst nestedCloudAssemblyProperties: cloud_assembly_schema.NestedCloudAssemblyProperties = {\n  directoryName: 'directoryName',\n\n  // the properties below are optional\n  displayName: 'displayName',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Artifact properties for nested cloud assemblies."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.NestedCloudAssemblyProperties",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 184
+        "line": 183
       },
       "name": "NestedCloudAssemblyProperties",
       "properties": [
@@ -5111,7 +4962,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 188
+            "line": 187
           },
           "name": "directoryName",
           "type": {
@@ -5128,7 +4979,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 195
+            "line": 194
           },
           "name": "displayName",
           "optional": true,
@@ -5145,17 +4996,13 @@
       "docs": {
         "remarks": "This alternate branch is necessary because it needs to be able to escape all type checking\nwe do on on the cloud assembly -- we cannot know the properties that will be used a priori.",
         "stability": "stable",
-        "summary": "Query input for plugins.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst pluginContextQuery: cloud_assembly_schema.PluginContextQuery = {\n  pluginName: 'pluginName',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for plugins."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.PluginContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 487
+        "line": 486
       },
       "name": "PluginContextQuery",
       "properties": [
@@ -5168,7 +5015,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 491
+            "line": 490
           },
           "name": "pluginName",
           "type": {
@@ -5221,11 +5068,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Information about the application's runtime components.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst runtimeInfo: cloud_assembly_schema.RuntimeInfo = {\n  libraries: {\n    librariesKey: 'libraries',\n  },\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Information about the application's runtime components."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.RuntimeInfo",
       "kind": "interface",
@@ -5264,17 +5107,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to SSM Parameter Context Provider.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst sSMParameterContextQuery: cloud_assembly_schema.SSMParameterContextQuery = {\n  account: 'account',\n  parameterName: 'parameterName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query to SSM Parameter Context Provider."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SSMParameterContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 167
+        "line": 166
       },
       "name": "SSMParameterContextQuery",
       "properties": [
@@ -5287,7 +5126,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 171
+            "line": 170
           },
           "name": "account",
           "type": {
@@ -5303,7 +5142,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 188
+            "line": 187
           },
           "name": "parameterName",
           "type": {
@@ -5319,7 +5158,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 176
+            "line": 175
           },
           "name": "region",
           "type": {
@@ -5336,7 +5175,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 183
+            "line": 182
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -5352,17 +5191,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a security group.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst securityGroupContextQuery: cloud_assembly_schema.SecurityGroupContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  securityGroupId: 'securityGroupId',\n  securityGroupName: 'securityGroupName',\n  vpcId: 'vpcId',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for looking up a security group."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SecurityGroupContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 414
+        "line": 413
       },
       "name": "SecurityGroupContextQuery",
       "properties": [
@@ -5375,7 +5210,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 418
+            "line": 417
           },
           "name": "account",
           "type": {
@@ -5391,7 +5226,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 423
+            "line": 422
           },
           "name": "region",
           "type": {
@@ -5408,7 +5243,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 430
+            "line": 429
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -5426,7 +5261,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 437
+            "line": 436
           },
           "name": "securityGroupId",
           "optional": true,
@@ -5444,7 +5279,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 444
+            "line": 443
           },
           "name": "securityGroupName",
           "optional": true,
@@ -5462,7 +5297,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 451
+            "line": 450
           },
           "name": "vpcId",
           "optional": true,
@@ -5478,11 +5313,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Metadata Entry spec for stack tag.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst tag: cloud_assembly_schema.Tag = {\n  key: 'key',\n  value: 'value',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Metadata Entry spec for stack tag."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.Tag",
       "kind": "interface",
@@ -5534,11 +5365,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents an integration test case.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst testCase: cloud_assembly_schema.TestCase = {\n  stacks: ['stacks'],\n\n  // the properties below are optional\n  allowDestroy: ['allowDestroy'],\n  assertionStack: 'assertionStack',\n  assertionStackName: 'assertionStackName',\n  cdkCommandOptions: {\n    deploy: {\n      args: {\n        all: false,\n        app: 'app',\n        assetMetadata: false,\n        caBundlePath: 'caBundlePath',\n        changeSetName: 'changeSetName',\n        ci: false,\n        color: false,\n        concurrency: 123,\n        context: {\n          contextKey: 'context',\n        },\n        debug: false,\n        ec2Creds: false,\n        exclusively: false,\n        execute: false,\n        force: false,\n        ignoreErrors: false,\n        json: false,\n        lookups: false,\n        notices: false,\n        notificationArns: ['notificationArns'],\n        output: 'output',\n        outputsFile: 'outputsFile',\n        parameters: {\n          parametersKey: 'parameters',\n        },\n        pathMetadata: false,\n        profile: 'profile',\n        proxy: 'proxy',\n        requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n        reuseAssets: ['reuseAssets'],\n        roleArn: 'roleArn',\n        rollback: false,\n        stacks: ['stacks'],\n        staging: false,\n        strict: false,\n        toolkitStackName: 'toolkitStackName',\n        trace: false,\n        usePreviousParameters: false,\n        verbose: false,\n        versionReporting: false,\n      },\n      enabled: false,\n      expectedMessage: 'expectedMessage',\n      expectError: false,\n    },\n    destroy: {\n      args: {\n        all: false,\n        app: 'app',\n        assetMetadata: false,\n        caBundlePath: 'caBundlePath',\n        color: false,\n        context: {\n          contextKey: 'context',\n        },\n        debug: false,\n        ec2Creds: false,\n        exclusively: false,\n        force: false,\n        ignoreErrors: false,\n        json: false,\n        lookups: false,\n        notices: false,\n        output: 'output',\n        pathMetadata: false,\n        profile: 'profile',\n        proxy: 'proxy',\n        roleArn: 'roleArn',\n        stacks: ['stacks'],\n        staging: false,\n        strict: false,\n        trace: false,\n        verbose: false,\n        versionReporting: false,\n      },\n      enabled: false,\n      expectedMessage: 'expectedMessage',\n      expectError: false,\n    },\n  },\n  diffAssets: false,\n  hooks: {\n    postDeploy: ['postDeploy'],\n    postDestroy: ['postDestroy'],\n    preDeploy: ['preDeploy'],\n    preDestroy: ['preDestroy'],\n  },\n  regions: ['regions'],\n  stackUpdateWorkflow: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Represents an integration test case."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TestCase",
       "interfaces": [
@@ -5617,11 +5444,7 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "The set of options to control the workflow of the test runner.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst testOptions: cloud_assembly_schema.TestOptions = {\n  allowDestroy: ['allowDestroy'],\n  cdkCommandOptions: {\n    deploy: {\n      args: {\n        all: false,\n        app: 'app',\n        assetMetadata: false,\n        caBundlePath: 'caBundlePath',\n        changeSetName: 'changeSetName',\n        ci: false,\n        color: false,\n        concurrency: 123,\n        context: {\n          contextKey: 'context',\n        },\n        debug: false,\n        ec2Creds: false,\n        exclusively: false,\n        execute: false,\n        force: false,\n        ignoreErrors: false,\n        json: false,\n        lookups: false,\n        notices: false,\n        notificationArns: ['notificationArns'],\n        output: 'output',\n        outputsFile: 'outputsFile',\n        parameters: {\n          parametersKey: 'parameters',\n        },\n        pathMetadata: false,\n        profile: 'profile',\n        proxy: 'proxy',\n        requireApproval: cloud_assembly_schema.RequireApproval.NEVER,\n        reuseAssets: ['reuseAssets'],\n        roleArn: 'roleArn',\n        rollback: false,\n        stacks: ['stacks'],\n        staging: false,\n        strict: false,\n        toolkitStackName: 'toolkitStackName',\n        trace: false,\n        usePreviousParameters: false,\n        verbose: false,\n        versionReporting: false,\n      },\n      enabled: false,\n      expectedMessage: 'expectedMessage',\n      expectError: false,\n    },\n    destroy: {\n      args: {\n        all: false,\n        app: 'app',\n        assetMetadata: false,\n        caBundlePath: 'caBundlePath',\n        color: false,\n        context: {\n          contextKey: 'context',\n        },\n        debug: false,\n        ec2Creds: false,\n        exclusively: false,\n        force: false,\n        ignoreErrors: false,\n        json: false,\n        lookups: false,\n        notices: false,\n        output: 'output',\n        pathMetadata: false,\n        profile: 'profile',\n        proxy: 'proxy',\n        roleArn: 'roleArn',\n        stacks: ['stacks'],\n        staging: false,\n        strict: false,\n        trace: false,\n        verbose: false,\n        versionReporting: false,\n      },\n      enabled: false,\n      expectedMessage: 'expectedMessage',\n      expectError: false,\n    },\n  },\n  diffAssets: false,\n  hooks: {\n    postDeploy: ['postDeploy'],\n    postDestroy: ['postDestroy'],\n    preDeploy: ['preDeploy'],\n    preDestroy: ['preDestroy'],\n  },\n  regions: ['regions'],\n  stackUpdateWorkflow: false,\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "The set of options to control the workflow of the test runner."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TestOptions",
       "kind": "interface",
@@ -5760,17 +5583,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for the Construct Tree Artifact.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst treeArtifactProperties: cloud_assembly_schema.TreeArtifactProperties = {\n  file: 'file',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Artifact properties for the Construct Tree Artifact."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TreeArtifactProperties",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/artifact-schema.ts",
-        "line": 174
+        "line": 173
       },
       "name": "TreeArtifactProperties",
       "properties": [
@@ -5783,7 +5602,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 178
+            "line": 177
           },
           "name": "file",
           "type": {
@@ -5798,17 +5617,13 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a VPC.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as cloud_assembly_schema from '@aws-cdk/cloud-assembly-schema';\nconst vpcContextQuery: cloud_assembly_schema.VpcContextQuery = {\n  account: 'account',\n  filter: {\n    filterKey: 'filter',\n  },\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  returnAsymmetricSubnets: false,\n  returnVpnGateways: false,\n  subnetGroupNameTag: 'subnetGroupNameTag',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+        "summary": "Query input for looking up a VPC."
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.VpcContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 194
+        "line": 193
       },
       "name": "VpcContextQuery",
       "properties": [
@@ -5821,7 +5636,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 198
+            "line": 197
           },
           "name": "account",
           "type": {
@@ -5839,7 +5654,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 219
+            "line": 218
           },
           "name": "filter",
           "type": {
@@ -5860,7 +5675,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 203
+            "line": 202
           },
           "name": "region",
           "type": {
@@ -5877,7 +5692,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 210
+            "line": 209
           },
           "name": "lookupRoleArn",
           "optional": true,
@@ -5895,7 +5710,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 227
+            "line": 226
           },
           "name": "returnAsymmetricSubnets",
           "optional": true,
@@ -5914,7 +5729,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 247
+            "line": 246
           },
           "name": "returnVpnGateways",
           "optional": true,
@@ -5933,7 +5748,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 237
+            "line": 236
           },
           "name": "subnetGroupNameTag",
           "optional": true,
@@ -5945,6 +5760,6 @@
       "symbolId": "lib/cloud-assembly/context-queries:VpcContextQuery"
     }
   },
-  "version": "2.151.0",
-  "fingerprint": "**********"
+  "version": "36.0.1",
+  "fingerprint": "N+2zh/iQfnHjKcjBaYsH5btVXAvRBa+q72QZNaif8qo="
 }