@aws-cdk/cloud-assembly-schema 53.27.0 → 54.0.0

package/.jsii

@@ -9,7 +9,7 @@
   },
   "bundled": {
     "jsonschema": "^1.5.0",
-    "semver": "^7.8.0"
+    "semver": "^7.8.1"
   },
   "description": "Schema for the protocol between CDK framework and CDK CLI",
   "docs": {
@@ -74,7 +74,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to AMI context provider."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n  owners: ['owners'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AmiContextQuery",
       "interfaces": [
@@ -144,7 +148,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A manifest for a single artifact within the cloud assembly."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst artifactManifest: cloud_assembly_schema.ArtifactManifest = {\n  type: cloud_assembly_schema.ArtifactType.NONE,\n\n  // the properties below are optional\n  additionalMetadataFile: 'additionalMetadataFile',\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    assumeRoleAdditionalOptions: {\n      assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n    },\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      assumeRoleAdditionalOptions: {\n        assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n      },\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n      requiresBootstrapStackVersion: 123,\n    },\n    notificationArns: ['notificationArns'],\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ArtifactManifest",
       "kind": "interface",
@@ -461,7 +469,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A manifest which describes the cloud assembly."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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      additionalMetadataFile: 'additionalMetadataFile',\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        assumeRoleAdditionalOptions: {\n          assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n        },\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          assumeRoleAdditionalOptions: {\n            assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n          },\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n          requiresBootstrapStackVersion: 123,\n        },\n        notificationArns: ['notificationArns'],\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  minimumCliVersion: 'minimumCliVersion',\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      assumeRoleAdditionalOptions: {\n        assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n      },\n      lookupRoleArn: 'lookupRoleArn',\n      lookupRoleExternalId: 'lookupRoleExternalId',\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssemblyManifest",
       "kind": "interface",
@@ -579,7 +591,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Definitions for the asset manifest."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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          assumeRoleAdditionalOptions: {\n            assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n          },\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        dockerBuildContexts: {\n          dockerBuildContextsKey: 'dockerBuildContexts',\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      // the properties below are optional\n      displayName: 'displayName',\n    },\n  },\n  files: {\n    filesKey: {\n      destinations: {\n        destinationsKey: {\n          bucketName: 'bucketName',\n          objectKey: 'objectKey',\n\n          // the properties below are optional\n          assumeRoleAdditionalOptions: {\n            assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n          },\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      // the properties below are optional\n      displayName: 'displayName',\n    },\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifest",
       "kind": "interface",
@@ -659,7 +675,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Configuration options for the Asset Manifest."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifestOptions",
       "kind": "interface",
@@ -714,7 +734,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for the Asset Manifest."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifestProperties",
       "interfaces": [
@@ -751,7 +775,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to availability zone context provider."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst availabilityZonesContextQuery: cloud_assembly_schema.AvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AvailabilityZonesContextQuery",
       "interfaces": [
@@ -770,7 +798,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for CloudFormation stacks."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst awsCloudFormationStackProperties: cloud_assembly_schema.AwsCloudFormationStackProperties = {\n  templateFile: 'templateFile',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\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    assumeRoleAdditionalOptions: {\n      assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n    },\n    assumeRoleExternalId: 'assumeRoleExternalId',\n    bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n    requiresBootstrapStackVersion: 123,\n  },\n  notificationArns: ['notificationArns'],\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AwsCloudFormationStackProperties",
       "kind": "interface",
@@ -1080,7 +1112,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Destination for assets that need to be uploaded to AWS."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst awsDestination: cloud_assembly_schema.AwsDestination = {\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AwsDestination",
       "kind": "interface",
@@ -1177,7 +1213,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Information needed to access an IAM role created as part of the bootstrap process."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst bootstrapRole: cloud_assembly_schema.BootstrapRole = {\n  arn: 'arn',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  requiresBootstrapStackVersion: 123,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.BootstrapRole",
       "kind": "interface",
@@ -1476,13 +1516,17 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk command i.e. `synth`, `deploy`, & `destroy`."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.CdkCommand",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 135
+        "line": 145
       },
       "name": "CdkCommand",
       "properties": [
@@ -1496,7 +1540,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 144
+            "line": 154
           },
           "name": "enabled",
           "optional": true,
@@ -1514,7 +1558,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 159
+            "line": 169
           },
           "name": "expectedMessage",
           "optional": true,
@@ -1532,7 +1576,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 151
+            "line": 161
           },
           "name": "expectError",
           "optional": true,
@@ -1548,13 +1592,17 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for specific cdk commands that are run as part of the integration test workflow."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.CdkCommands",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 192
+        "line": 202
       },
       "name": "CdkCommands",
       "properties": [
@@ -1568,7 +1616,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 198
+            "line": 208
           },
           "name": "deploy",
           "optional": true,
@@ -1586,7 +1634,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 205
+            "line": 215
           },
           "name": "destroy",
           "optional": true,
@@ -1602,13 +1650,17 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A node in the construct creation stack trace."
+        "summary": "A node in the construct creation stack trace.",
+        "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 cloudFormationResourceJson: cloud_assembly_schema.CloudFormationResourceJson = {\n  logicalId: 'logicalId',\n  templatePath: 'templatePath',\n\n  // the properties below are optional\n  propertyPaths: ['propertyPaths'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.CloudFormationResourceJson",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/validation-report-schema.ts",
-        "line": 167
+        "line": 256
       },
       "name": "CloudFormationResourceJson",
       "properties": [
@@ -1621,7 +1673,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 176
+            "line": 265
           },
           "name": "logicalId",
           "type": {
@@ -1637,7 +1689,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 171
+            "line": 260
           },
           "name": "templatePath",
           "type": {
@@ -1655,7 +1707,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 186
+            "line": 275
           },
           "name": "propertyPaths",
           "optional": true,
@@ -1676,7 +1728,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for configuring the Docker cache backend."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ContainerImageAssetCacheOption",
       "kind": "interface",
@@ -2123,7 +2179,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for context lookup roles."
+        "summary": "Options for context lookup roles.",
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst contextLookupRoleOptions: cloud_assembly_schema.ContextLookupRoleOptions = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ContextLookupRoleOptions",
       "kind": "interface",
@@ -2335,7 +2395,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Default CDK CLI options that apply to all commands."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DefaultCdkOptions",
       "kind": "interface",
@@ -2782,7 +2846,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk deploy command."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DeployCommand",
       "interfaces": [
@@ -2791,7 +2859,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 165
+        "line": 175
       },
       "name": "DeployCommand",
       "properties": [
@@ -2805,7 +2873,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 172
+            "line": 182
           },
           "name": "args",
           "optional": true,
@@ -2821,7 +2889,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options to use with cdk deploy."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DeployOptions",
       "interfaces": [
@@ -3111,7 +3183,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a cdk destroy command."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DestroyCommand",
       "interfaces": [
@@ -3120,7 +3196,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 178
+        "line": 188
       },
       "name": "DestroyCommand",
       "properties": [
@@ -3134,7 +3210,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 185
+            "line": 195
           },
           "name": "args",
           "optional": true,
@@ -3150,7 +3226,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options to use with cdk destroy."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DestroyOptions",
       "interfaces": [
@@ -3207,7 +3287,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for configuring the Docker cache backend."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerCacheOption",
       "kind": "interface",
@@ -3269,7 +3353,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A file asset."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst dockerImageAsset: cloud_assembly_schema.DockerImageAsset = {\n  destinations: {\n    destinationsKey: {\n      imageTag: 'imageTag',\n      repositoryName: 'repositoryName',\n\n      // the properties below are optional\n      assumeRoleAdditionalOptions: {\n        assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n      },\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    dockerBuildContexts: {\n      dockerBuildContextsKey: 'dockerBuildContexts',\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  // the properties below are optional\n  displayName: 'displayName',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageAsset",
       "kind": "interface",
@@ -3342,7 +3430,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Where to publish docker images."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst dockerImageDestination: cloud_assembly_schema.DockerImageDestination = {\n  imageTag: 'imageTag',\n  repositoryName: 'repositoryName',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageDestination",
       "interfaces": [
@@ -3395,7 +3487,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Properties for how to produce a Docker image from a source."
+        "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  dockerBuildContexts: {\n    dockerBuildContextsKey: 'dockerBuildContexts',\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageSource",
       "kind": "interface",
@@ -3707,7 +3803,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to endpoint service context provider."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst endpointServiceAvailabilityZonesContextQuery: cloud_assembly_schema.EndpointServiceAvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n  serviceName: 'serviceName',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.EndpointServiceAvailabilityZonesContextQuery",
       "interfaces": [
@@ -3744,7 +3844,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A single feature flag."
+        "summary": "A single feature flag.",
+        "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';\n\ndeclare const recommendedValue: any;\ndeclare const userValue: any;\ndeclare const v1: any;\ndeclare const v2: any;\nconst featureFlag: cloud_assembly_schema.FeatureFlag = {\n  explanation: 'explanation',\n  recommendedValue: recommendedValue,\n  unconfiguredBehavesLike: {\n    v1: v1,\n    v2: v2,\n  },\n  userValue: userValue,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FeatureFlag",
       "kind": "interface",
@@ -3838,7 +3942,11 @@
       "docs": {
         "remarks": "A feature flag report is small enough that all the properties can be inlined\nhere, and doesn't need an additional file.",
         "stability": "stable",
-        "summary": "Artifact properties for a feature flag report."
+        "summary": "Artifact properties for a feature flag report.",
+        "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';\n\ndeclare const recommendedValue: any;\ndeclare const userValue: any;\ndeclare const v1: any;\ndeclare const v2: any;\nconst featureFlagReportProperties: cloud_assembly_schema.FeatureFlagReportProperties = {\n  flags: {\n    flagsKey: {\n      explanation: 'explanation',\n      recommendedValue: recommendedValue,\n      unconfiguredBehavesLike: {\n        v1: v1,\n        v2: v2,\n      },\n      userValue: userValue,\n    },\n  },\n  module: 'module',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FeatureFlagReportProperties",
       "kind": "interface",
@@ -3893,7 +4001,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A file asset."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst fileAsset: cloud_assembly_schema.FileAsset = {\n  destinations: {\n    destinationsKey: {\n      bucketName: 'bucketName',\n      objectKey: 'objectKey',\n\n      // the properties below are optional\n      assumeRoleAdditionalOptions: {\n        assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n      },\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  // the properties below are optional\n  displayName: 'displayName',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileAsset",
       "kind": "interface",
@@ -4128,7 +4240,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Where in S3 a file asset needs to be published."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst fileDestination: cloud_assembly_schema.FileDestination = {\n  bucketName: 'bucketName',\n  objectKey: 'objectKey',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileDestination",
       "interfaces": [
@@ -4181,7 +4297,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Describe the source of a file asset."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileSource",
       "kind": "interface",
@@ -4260,13 +4380,17 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Commands to run at predefined points during the integration test workflow."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.Hooks",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 97
+        "line": 107
       },
       "name": "Hooks",
       "properties": [
@@ -4280,7 +4404,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 112
+            "line": 122
           },
           "name": "postDeploy",
           "optional": true,
@@ -4303,7 +4427,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 128
+            "line": 138
           },
           "name": "postDestroy",
           "optional": true,
@@ -4326,7 +4450,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 104
+            "line": 114
           },
           "name": "preDeploy",
           "optional": true,
@@ -4349,7 +4473,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 120
+            "line": 130
           },
           "name": "preDestroy",
           "optional": true,
@@ -4370,7 +4494,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to hosted zone context provider."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst hostedZoneContextQuery: cloud_assembly_schema.HostedZoneContextQuery = {\n  account: 'account',\n  domainName: 'domainName',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n  privateZone: false,\n  vpcId: 'vpcId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.HostedZoneContextQuery",
       "interfaces": [
@@ -4479,7 +4607,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Definitions for the integration testing manifest."
+        "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      allowDeleteFailures: false,\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.IntegManifest",
       "kind": "interface",
@@ -4577,7 +4709,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a KMS Key."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst keyContextQuery: cloud_assembly_schema.KeyContextQuery = {\n  account: 'account',\n  aliasName: 'aliasName',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.KeyContextQuery",
       "interfaces": [
@@ -4614,7 +4750,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a load balancer."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerContextQuery",
       "interfaces": [
@@ -4633,7 +4773,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Filters for selecting load balancers."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst loadBalancerFilter: cloud_assembly_schema.LoadBalancerFilter = {\n  account: 'account',\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerFilter",
       "interfaces": [
@@ -4711,7 +4855,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a load balancer listener."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\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  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerListenerContextQuery",
       "interfaces": [
@@ -4876,7 +5024,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Options for the loadManifest operation."
+        "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  validateSchema: false,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadManifestOptions",
       "kind": "interface",
@@ -5296,7 +5448,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A metadata entry in a cloud assembly artifact."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.MetadataEntry",
       "kind": "interface",
@@ -5409,7 +5565,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents a missing piece of context."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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    assumeRoleAdditionalOptions: {\n      assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n    },\n    lookupRoleArn: 'lookupRoleArn',\n    lookupRoleExternalId: 'lookupRoleExternalId',\n    owners: ['owners'],\n  },\n  provider: cloud_assembly_schema.ContextProvider.AMI_PROVIDER,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.MissingContext",
       "kind": "interface",
@@ -5514,7 +5674,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for nested cloud assemblies."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.NestedCloudAssemblyProperties",
       "kind": "interface",
@@ -5567,7 +5731,11 @@
       "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."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.PluginContextQuery",
       "kind": "interface",
@@ -5600,6 +5768,7 @@
       "assembly": "@aws-cdk/cloud-assembly-schema",
       "datatype": true,
       "docs": {
+        "example": "import { PluginReportJson } from '@aws-cdk/cloud-assembly-schema';\n\nconst report: PluginReportJson = {\n  pluginName: 'my-plugin',\n  conclusion: 'success',\n  violations: [],\n};",
         "stability": "stable",
         "summary": "A report from a single validation plugin."
       },
@@ -5607,7 +5776,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/validation-report-schema.ts",
-        "line": 31
+        "line": 52
       },
       "name": "PluginReportJson",
       "properties": [
@@ -5620,7 +5789,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 47
+            "line": 68
           },
           "name": "conclusion",
           "type": {
@@ -5636,7 +5805,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 35
+            "line": 56
           },
           "name": "pluginName",
           "type": {
@@ -5652,7 +5821,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 59
+            "line": 80
           },
           "name": "violations",
           "type": {
@@ -5674,7 +5843,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 54
+            "line": 75
           },
           "name": "metadata",
           "optional": true,
@@ -5697,13 +5866,37 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 42
+            "line": 63
           },
           "name": "pluginVersion",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no suppressed violations",
+            "remarks": "These violations matched an acknowledged rule ID and were excluded\nfrom the active violations list. They are retained for audit\ntrail and reporting purposes.",
+            "stability": "stable",
+            "summary": "Violations that were suppressed via acknowledgement."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/validation-report-schema.ts",
+            "line": 91
+          },
+          "name": "suppressedViolations",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/cloud-assembly-schema.SuppressedViolationJson"
+              },
+              "kind": "array"
+            }
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/validation-report-schema:PluginReportJson"
@@ -5712,6 +5905,7 @@
       "assembly": "@aws-cdk/cloud-assembly-schema",
       "datatype": true,
       "docs": {
+        "example": "import { PolicyValidationReportJson } from '@aws-cdk/cloud-assembly-schema';\n\nconst report: PolicyValidationReportJson = {\n  version: '1.0',\n  pluginReports: [{\n    pluginName: 'my-plugin',\n    conclusion: 'success',\n    violations: [],\n  }],\n};",
         "stability": "stable",
         "summary": "The top-level structure of the policy validation report file."
       },
@@ -5719,7 +5913,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/validation-report-schema.ts",
-        "line": 11
+        "line": 23
       },
       "name": "PolicyValidationReportJson",
       "properties": [
@@ -5732,7 +5926,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 25
+            "line": 37
           },
           "name": "pluginReports",
           "type": {
@@ -5753,7 +5947,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 15
+            "line": 27
           },
           "name": "version",
           "type": {
@@ -5769,7 +5963,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 20
+            "line": 32
           },
           "name": "title",
           "optional": true,
@@ -5784,6 +5978,7 @@
       "assembly": "@aws-cdk/cloud-assembly-schema",
       "datatype": true,
       "docs": {
+        "example": "import { PolicyViolationJson } from '@aws-cdk/cloud-assembly-schema';\n\nconst violation: PolicyViolationJson = {\n  ruleName: 'no-public-access',\n  description: 'S3 bucket should not allow public access',\n  severity: 'error',\n  violatingConstructs: [{ constructPath: 'MyStack/MyBucket' }],\n};",
         "stability": "stable",
         "summary": "A single policy violation found by a validation plugin."
       },
@@ -5791,7 +5986,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/validation-report-schema.ts",
-        "line": 70
+        "line": 112
       },
       "name": "PolicyViolationJson",
       "properties": [
@@ -5804,7 +5999,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 79
+            "line": 121
           },
           "name": "description",
           "type": {
@@ -5820,7 +6015,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 74
+            "line": 116
           },
           "name": "ruleName",
           "type": {
@@ -5836,7 +6031,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 91
+            "line": 133
           },
           "name": "severity",
           "type": {
@@ -5852,7 +6047,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 108
+            "line": 150
           },
           "name": "violatingConstructs",
           "type": {
@@ -5873,7 +6068,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 96
+            "line": 138
           },
           "name": "customSeverity",
           "optional": true,
@@ -5891,7 +6086,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 103
+            "line": 145
           },
           "name": "ruleMetadata",
           "optional": true,
@@ -5914,7 +6109,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 86
+            "line": 128
           },
           "name": "suggestedFix",
           "optional": true,
@@ -5930,7 +6125,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Metadata type of a PropertyMutation."
+        "summary": "Metadata type of a PropertyMutation.",
+        "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 propertyMutationMetadataEntry: cloud_assembly_schema.PropertyMutationMetadataEntry = {\n  propertyName: 'propertyName',\n  stackTrace: ['stackTrace'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.PropertyMutationMetadataEntry",
       "kind": "interface",
@@ -6023,7 +6222,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Information about the application's runtime components."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.RuntimeInfo",
       "kind": "interface",
@@ -6062,7 +6265,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query to SSM Parameter Context Provider."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst sSMParameterContextQuery: cloud_assembly_schema.SSMParameterContextQuery = {\n  account: 'account',\n  parameterName: 'parameterName',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SSMParameterContextQuery",
       "interfaces": [
@@ -6099,7 +6306,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a security group."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\nconst securityGroupContextQuery: cloud_assembly_schema.SecurityGroupContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n  securityGroupId: 'securityGroupId',\n  securityGroupName: 'securityGroupName',\n  vpcId: 'vpcId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SecurityGroupContextQuery",
       "interfaces": [
@@ -6169,12 +6380,110 @@
       ],
       "symbolId": "lib/cloud-assembly/context-queries:SecurityGroupContextQuery"
     },
+    "@aws-cdk/cloud-assembly-schema.SuppressedViolationJson": {
+      "assembly": "@aws-cdk/cloud-assembly-schema",
+      "datatype": true,
+      "docs": {
+        "example": "import { SuppressedViolationJson } from '@aws-cdk/cloud-assembly-schema';\n\nconst suppressed: SuppressedViolationJson = {\n  ruleName: 'no-public-access',\n  description: 'S3 bucket should not allow public access',\n  severity: 'warning',\n  violatingConstructs: [{ constructPath: 'MyStack/MyBucket' }],\n  acknowledgedId: 'my-plugin::no-public-access',\n};",
+        "stability": "stable",
+        "summary": "A violation that was acknowledged/suppressed and excluded from the active violation set."
+      },
+      "fqn": "@aws-cdk/cloud-assembly-schema.SuppressedViolationJson",
+      "interfaces": [
+        "@aws-cdk/cloud-assembly-schema.PolicyViolationJson"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/cloud-assembly/validation-report-schema.ts",
+        "line": 221
+      },
+      "name": "SuppressedViolationJson",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Format: `<plugin-name>::<rule-name>` (spaces replaced with hyphens).",
+            "stability": "stable",
+            "summary": "The acknowledgement ID that caused this violation to be suppressed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/validation-report-schema.ts",
+            "line": 227
+          },
+          "name": "acknowledgedId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- unknown",
+            "stability": "stable",
+            "summary": "The construct path where the acknowledgement was declared."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/validation-report-schema.ts",
+            "line": 241
+          },
+          "name": "acknowledgedAt",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no stack trace",
+            "remarks": "A `\\n`-delimited string of stack frames.",
+            "stability": "stable",
+            "summary": "Stack trace showing where the acknowledgement was declared."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/validation-report-schema.ts",
+            "line": 250
+          },
+          "name": "acknowledgedStackTrace",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no reason given",
+            "stability": "stable",
+            "summary": "The reason given for the acknowledgement, if provided."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/validation-report-schema.ts",
+            "line": 234
+          },
+          "name": "reason",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/cloud-assembly/validation-report-schema:SuppressedViolationJson"
+    },
     "@aws-cdk/cloud-assembly-schema.Tag": {
       "assembly": "@aws-cdk/cloud-assembly-schema",
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Metadata Entry spec for stack tag."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.Tag",
       "kind": "interface",
@@ -6226,7 +6535,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Represents an integration test case."
+        "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  allowDeleteFailures: false,\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TestCase",
       "interfaces": [
@@ -6235,7 +6548,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/integ-tests/test-case.ts",
-        "line": 68
+        "line": 78
       },
       "name": "TestCase",
       "properties": [
@@ -6248,7 +6561,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 75
+            "line": 85
           },
           "name": "stacks",
           "type": {
@@ -6271,7 +6584,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 83
+            "line": 93
           },
           "name": "assertionStack",
           "optional": true,
@@ -6289,7 +6602,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 90
+            "line": 100
           },
           "name": "assertionStackName",
           "optional": true,
@@ -6305,7 +6618,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "The set of options to control the workflow of the test runner."
+        "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  allowDeleteFailures: false,\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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TestOptions",
       "kind": "interface",
@@ -6315,6 +6632,25 @@
       },
       "name": "TestOptions",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "When false, the test will fail if CloudFormation skips deleting a resource\nduring a stack update. When true, only a warning is printed.",
+            "stability": "stable",
+            "summary": "Whether to allow resources that fail to delete during a stack update."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/integ-tests/test-case.ts",
+            "line": 40
+          },
+          "name": "allowDeleteFailures",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -6326,7 +6662,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 55
+            "line": 65
           },
           "name": "allowDestroy",
           "optional": true,
@@ -6368,7 +6704,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 40
+            "line": 50
           },
           "name": "diffAssets",
           "optional": true,
@@ -6405,7 +6741,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/integ-tests/test-case.ts",
-            "line": 62
+            "line": 72
           },
           "name": "regions",
           "optional": true,
@@ -6444,7 +6780,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Artifact properties for the Construct Tree Artifact."
+        "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"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TreeArtifactProperties",
       "kind": "interface",
@@ -6477,7 +6817,11 @@
       "assembly": "@aws-cdk/cloud-assembly-schema",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "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';\n\ndeclare const v1: any;\ndeclare const v2: any;\nconst unconfiguredBehavesLike: cloud_assembly_schema.UnconfiguredBehavesLike = {\n  v1: v1,\n  v2: v2,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.UnconfiguredBehavesLike",
       "kind": "interface",
@@ -6533,13 +6877,17 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "A construct that violated a policy rule."
+        "summary": "A construct that violated a policy rule.",
+        "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 violatingConstructJson: cloud_assembly_schema.ViolatingConstructJson = {\n  constructPath: 'constructPath',\n\n  // the properties below are optional\n  cloudFormationResource: {\n    logicalId: 'logicalId',\n    templatePath: 'templatePath',\n\n    // the properties below are optional\n    propertyPaths: ['propertyPaths'],\n  },\n  constructFqn: 'constructFqn',\n  libraryVersion: 'libraryVersion',\n  stackTraces: ['stackTraces'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ViolatingConstructJson",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/validation-report-schema.ts",
-        "line": 122
+        "line": 164
       },
       "name": "ViolatingConstructJson",
       "properties": [
@@ -6553,7 +6901,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 128
+            "line": 170
           },
           "name": "constructPath",
           "type": {
@@ -6569,7 +6917,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 149
+            "line": 191
           },
           "name": "cloudFormationResource",
           "optional": true,
@@ -6587,7 +6935,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 135
+            "line": 177
           },
           "name": "constructFqn",
           "optional": true,
@@ -6606,7 +6954,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 144
+            "line": 186
           },
           "name": "libraryVersion",
           "optional": true,
@@ -6625,7 +6973,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/validation-report-schema.ts",
-            "line": 161
+            "line": 203
           },
           "name": "stackTraces",
           "optional": true,
@@ -6646,7 +6994,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Query input for looking up a VPC."
+        "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';\n\ndeclare const assumeRoleAdditionalOptions: any;\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  assumeRoleAdditionalOptions: {\n    assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,\n  },\n  lookupRoleArn: 'lookupRoleArn',\n  lookupRoleExternalId: 'lookupRoleExternalId',\n  returnAsymmetricSubnets: false,\n  returnVpnGateways: false,\n  subnetGroupNameTag: 'subnetGroupNameTag',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.VpcContextQuery",
       "interfaces": [
@@ -6742,6 +7094,6 @@
       "symbolId": "lib/cloud-assembly/context-queries:VpcContextQuery"
     }
   },
-  "version": "53.27.0",
-  "fingerprint": "t+1U9VaV9Pg4mRykhvCYxl6CkQAJo4lP/sqH77QxO+8="
+  "version": "54.0.0",
+  "fingerprint": "**********"
 }