@aws-cdk/cloud-assembly-schema 1.131.0 → 1.135.0

package/.jsii

@@ -16,7 +16,7 @@
     "stability": "stable"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "1.42.0 (build 5f6b62c)",
+  "jsiiVersion": "1.47.0 (build 86d2c33)",
   "keywords": [
     "aws",
     "cdk"
@@ -24,6 +24,7 @@
   "license": "Apache-2.0",
   "metadata": {
     "jsii": {
+      "compiledWithDeprecationWarnings": true,
       "pacmak": {
         "hasDefaultInterfaces": true
       },
@@ -73,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\nconst amiContextQuery: cloud_assembly_schema.AmiContextQuery = {\n  account: 'account',\n  filters: {\n    filtersKey: ['filters'],\n  },\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  owners: ['owners'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AmiContextQuery",
       "kind": "interface",
@@ -125,22 +130,6 @@
             }
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Region to query."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 70
-          },
-          "name": "region",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -181,6 +170,22 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Region to query."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 70
+          },
+          "name": "region",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/context-queries:AmiContextQuery"
@@ -190,7 +195,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\nconst artifactManifest: cloud_assembly_schema.ArtifactManifest = {\n  type: cloud_assembly_schema.ArtifactType.NONE,\n\n  // the properties below are optional\n  dependencies: ['dependencies'],\n  displayName: 'displayName',\n  environment: 'environment',\n  metadata: {\n    metadataKey: [{\n      type: 'type',\n\n      // the properties below are optional\n      data: 'data',\n      trace: ['trace'],\n    }],\n  },\n  properties: {\n    templateFile: 'templateFile',\n\n    // the properties below are optional\n    assumeRoleArn: 'assumeRoleArn',\n    assumeRoleExternalId: 'assumeRoleExternalId',\n    bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n    cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n    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",
@@ -200,22 +209,6 @@
       },
       "name": "ArtifactManifest",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The type of artifact."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/schema.ts",
-            "line": 72
-          },
-          "name": "type",
-          "type": {
-            "fqn": "@aws-cdk/cloud-assembly-schema.ArtifactType"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -336,6 +329,22 @@
               ]
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The type of artifact."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/schema.ts",
+            "line": 72
+          },
+          "name": "type",
+          "type": {
+            "fqn": "@aws-cdk/cloud-assembly-schema.ArtifactType"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/schema:ArtifactManifest"
@@ -415,9 +424,9 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Stub required because of JSII."
+            "summary": "Manifest for all assets in the Cloud Assembly."
           },
-          "name": "NONE"
+          "name": "ASSET_MANIFEST"
         },
         {
           "docs": {
@@ -436,16 +445,16 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Manifest for all assets in the Cloud Assembly."
+            "summary": "Nested Cloud Assembly."
           },
-          "name": "ASSET_MANIFEST"
+          "name": "NESTED_CLOUD_ASSEMBLY"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "Nested Cloud Assembly."
+            "summary": "Stub required because of JSII."
           },
-          "name": "NESTED_CLOUD_ASSEMBLY"
+          "name": "NONE"
         }
       ],
       "name": "ArtifactType",
@@ -456,7 +465,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\nconst assemblyManifest: cloud_assembly_schema.AssemblyManifest = {\n  version: 'version',\n\n  // the properties below are optional\n  artifacts: {\n    artifactsKey: {\n      type: cloud_assembly_schema.ArtifactType.NONE,\n\n      // the properties below are optional\n      dependencies: ['dependencies'],\n      displayName: 'displayName',\n      environment: 'environment',\n      metadata: {\n        metadataKey: [{\n          type: 'type',\n\n          // the properties below are optional\n          data: 'data',\n          trace: ['trace'],\n        }],\n      },\n      properties: {\n        templateFile: 'templateFile',\n\n        // the properties below are optional\n        assumeRoleArn: 'assumeRoleArn',\n        assumeRoleExternalId: 'assumeRoleExternalId',\n        bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n        cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n        parameters: {\n          parametersKey: 'parameters',\n        },\n        requiresBootstrapStackVersion: 123,\n        stackName: 'stackName',\n        stackTemplateAssetObjectUrl: 'stackTemplateAssetObjectUrl',\n        tags: {\n          tagsKey: 'tags',\n        },\n        terminationProtection: false,\n        validateOnSynth: false,\n      },\n    },\n  },\n  missing: [{\n    key: 'key',\n    props: {\n      account: 'account',\n      filters: {\n        filtersKey: ['filters'],\n      },\n      region: 'region',\n\n      // the properties below are optional\n      lookupRoleArn: 'lookupRoleArn',\n      owners: ['owners'],\n    },\n    provider: cloud_assembly_schema.ContextProvider.AMI_PROVIDER,\n  }],\n  runtime: {\n    libraries: {\n      librariesKey: 'libraries',\n    },\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssemblyManifest",
       "kind": "interface",
@@ -466,22 +479,6 @@
       },
       "name": "AssemblyManifest",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Protocol version."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/schema.ts",
-            "line": 117
-          },
-          "name": "version",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -546,6 +543,22 @@
           "type": {
             "fqn": "@aws-cdk/cloud-assembly-schema.RuntimeInfo"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Protocol version."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/schema.ts",
+            "line": 117
+          },
+          "name": "version",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/schema:AssemblyManifest"
@@ -555,7 +568,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\nconst assetManifest: cloud_assembly_schema.AssetManifest = {\n  version: 'version',\n\n  // the properties below are optional\n  dockerImages: {\n    dockerImagesKey: {\n      destinations: {\n        destinationsKey: {\n          imageTag: 'imageTag',\n          repositoryName: 'repositoryName',\n\n          // the properties below are optional\n          assumeRoleArn: 'assumeRoleArn',\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          region: 'region',\n        },\n      },\n      source: {\n        directory: 'directory',\n        dockerBuildArgs: {\n          dockerBuildArgsKey: 'dockerBuildArgs',\n        },\n        dockerBuildTarget: 'dockerBuildTarget',\n        dockerFile: 'dockerFile',\n        executable: ['executable'],\n      },\n    },\n  },\n  files: {\n    filesKey: {\n      destinations: {\n        destinationsKey: {\n          bucketName: 'bucketName',\n          objectKey: 'objectKey',\n\n          // the properties below are optional\n          assumeRoleArn: 'assumeRoleArn',\n          assumeRoleExternalId: 'assumeRoleExternalId',\n          region: 'region',\n        },\n      },\n      source: {\n        executable: ['executable'],\n        packaging: cloud_assembly_schema.FileAssetPackaging.FILE,\n        path: 'path',\n      },\n    },\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AssetManifest",
       "kind": "interface",
@@ -565,22 +582,6 @@
       },
       "name": "AssetManifest",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Version of the manifest."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/assets/schema.ts",
-            "line": 11
-          },
-          "name": "version",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -626,6 +627,22 @@
               "kind": "map"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Version of the manifest."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/assets/schema.ts",
+            "line": 11
+          },
+          "name": "version",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/assets/schema:AssetManifest"
@@ -635,7 +652,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';\n\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",
       "kind": "interface",
@@ -648,15 +669,18 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- Bootstrap stack version number looked up",
+            "remarks": "- If this value is not set, the bootstrap stack name must be known at\n   deployment time so the stack version can be looked up from the stack\n   outputs.\n- If this value is set, the bootstrap stack can have any name because\n   we won't need to look it up.",
             "stability": "stable",
-            "summary": "Filename of the asset manifest."
+            "summary": "SSM parameter where the bootstrap stack version number can be found."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 103
+            "line": 123
           },
-          "name": "file",
+          "name": "bootstrapStackVersionSsmParameter",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -664,18 +688,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- Bootstrap stack version number looked up",
-            "remarks": "- If this value is not set, the bootstrap stack name must be known at\n   deployment time so the stack version can be looked up from the stack\n   outputs.\n- If this value is set, the bootstrap stack can have any name because\n   we won't need to look it up.",
             "stability": "stable",
-            "summary": "SSM parameter where the bootstrap stack version number can be found."
+            "summary": "Filename of the asset manifest."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 123
+            "line": 103
           },
-          "name": "bootstrapStackVersionSsmParameter",
-          "optional": true,
+          "name": "file",
           "type": {
             "primitive": "string"
           }
@@ -706,7 +727,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\nconst availabilityZonesContextQuery: cloud_assembly_schema.AvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AvailabilityZonesContextQuery",
       "kind": "interface",
@@ -735,15 +760,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 104
+            "line": 111
           },
-          "name": "region",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -751,17 +778,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 111
+            "line": 104
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -774,7 +799,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\nconst awsCloudFormationStackProperties: cloud_assembly_schema.AwsCloudFormationStackProperties = {\n  templateFile: 'templateFile',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  bootstrapStackVersionSsmParameter: 'bootstrapStackVersionSsmParameter',\n  cloudFormationExecutionRoleArn: 'cloudFormationExecutionRoleArn',\n  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",
@@ -784,22 +813,6 @@
       },
       "name": "AwsCloudFormationStackProperties",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "A file relative to the assembly root which contains the CloudFormation template for this stack."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/artifact-schema.ts",
-            "line": 9
-          },
-          "name": "templateFile",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -973,6 +986,22 @@
             }
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "A file relative to the assembly root which contains the CloudFormation template for this stack."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/artifact-schema.ts",
+            "line": 9
+          },
+          "name": "templateFile",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -1017,7 +1046,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\nconst awsDestination: cloud_assembly_schema.AwsDestination = {\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.AwsDestination",
       "kind": "interface",
@@ -1089,7 +1122,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Metadata Entry spec for container images."
+        "summary": "Metadata Entry spec for container 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\nconst containerImageAssetMetadataEntry: cloud_assembly_schema.ContainerImageAssetMetadataEntry = {\n  id: 'id',\n  packaging: 'packaging',\n  path: 'path',\n  sourceHash: 'sourceHash',\n\n  // the properties below are optional\n  buildArgs: {\n    buildArgsKey: 'buildArgs',\n  },\n  file: 'file',\n  imageNameParameter: 'imageNameParameter',\n  imageTag: 'imageTag',\n  repositoryName: 'repositoryName',\n  target: 'target',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.ContainerImageAssetMetadataEntry",
       "kind": "interface",
@@ -1102,31 +1139,40 @@
         {
           "abstract": true,
           "docs": {
+            "default": "no build args are passed",
             "stability": "stable",
-            "summary": "Logical identifier for the asset."
+            "summary": "Build args to pass to the `docker build` command."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 13
+            "line": 119
           },
-          "name": "id",
+          "name": "buildArgs",
+          "optional": true,
           "type": {
-            "primitive": "string"
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
           }
         },
         {
           "abstract": true,
           "docs": {
+            "default": "- no file is passed",
             "stability": "stable",
-            "summary": "Type of asset."
+            "summary": "Path to the Dockerfile (relative to the directory)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 81
+            "line": 133
           },
-          "name": "packaging",
+          "name": "file",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -1135,14 +1181,14 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Path on disk to the asset."
+            "summary": "Logical identifier for the asset."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 23
+            "line": 13
           },
-          "name": "path",
+          "name": "id",
           "type": {
             "primitive": "string"
           }
@@ -1150,15 +1196,18 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "The hash of the asset source."
+            "default": "undefined If not specified, `repositoryName` and `imageTag` are\nrequired because otherwise how will the stack know where to find the asset,\nha?",
+            "deprecated": "specify `repositoryName` and `imageTag` instead, and then you\nknow where the image will go.",
+            "stability": "deprecated",
+            "summary": "ECR Repository name and repo digest (separated by \"@sha256:\") where this image is stored."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 18
+            "line": 93
           },
-          "name": "sourceHash",
+          "name": "imageNameParameter",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -1166,40 +1215,34 @@
         {
           "abstract": true,
           "docs": {
-            "default": "no build args are passed",
+            "default": "- this parameter is REQUIRED after 1.21.0",
+            "remarks": "This field is\nrequired if `imageParameterName` is ommited (otherwise, the app won't be\nable to find the image).",
             "stability": "stable",
-            "summary": "Build args to pass to the `docker build` command."
+            "summary": "The docker image tag to use for tagging pushed images."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 119
+            "line": 112
           },
-          "name": "buildArgs",
+          "name": "imageTag",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "primitive": "string"
-              },
-              "kind": "map"
-            }
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "- no file is passed",
             "stability": "stable",
-            "summary": "Path to the Dockerfile (relative to the directory)."
+            "summary": "Type of asset."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 133
+            "line": 81
           },
-          "name": "file",
-          "optional": true,
+          "name": "packaging",
           "type": {
             "primitive": "string"
           }
@@ -1207,18 +1250,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "undefined If not specified, `repositoryName` and `imageTag` are\nrequired because otherwise how will the stack know where to find the asset,\nha?",
-            "deprecated": "specify `repositoryName` and `imageTag` instead, and then you\nknow where the image will go.",
-            "stability": "deprecated",
-            "summary": "ECR Repository name and repo digest (separated by \"@sha256:\") where this image is stored."
+            "stability": "stable",
+            "summary": "Path on disk to the asset."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 93
+            "line": 23
           },
-          "name": "imageNameParameter",
-          "optional": true,
+          "name": "path",
           "type": {
             "primitive": "string"
           }
@@ -1227,16 +1267,16 @@
           "abstract": true,
           "docs": {
             "default": "- this parameter is REQUIRED after 1.21.0",
-            "remarks": "This field is\nrequired if `imageParameterName` is ommited (otherwise, the app won't be\nable to find the image).",
+            "remarks": "Specify this property if you need to statically address the\nimage, e.g. from a Kubernetes Pod. Note, this is only the repository name,\nwithout the registry and the tag parts.",
             "stability": "stable",
-            "summary": "The docker image tag to use for tagging pushed images."
+            "summary": "ECR repository name, if omitted a default name based on the asset's ID is used instead."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 112
+            "line": 103
           },
-          "name": "imageTag",
+          "name": "repositoryName",
           "optional": true,
           "type": {
             "primitive": "string"
@@ -1245,18 +1285,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- this parameter is REQUIRED after 1.21.0",
-            "remarks": "Specify this property if you need to statically address the\nimage, e.g. from a Kubernetes Pod. Note, this is only the repository name,\nwithout the registry and the tag parts.",
             "stability": "stable",
-            "summary": "ECR repository name, if omitted a default name based on the asset's ID is used instead."
+            "summary": "The hash of the asset source."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 103
+            "line": 18
           },
-          "name": "repositoryName",
-          "optional": true,
+          "name": "sourceHash",
           "type": {
             "primitive": "string"
           }
@@ -1312,30 +1349,30 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Route53 Hosted Zone provider."
+            "summary": "VPC Endpoint Service AZ Provider."
           },
-          "name": "HOSTED_ZONE_PROVIDER"
+          "name": "ENDPOINT_SERVICE_AVAILABILITY_ZONE_PROVIDER"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "SSM Parameter Provider."
+            "summary": "Route53 Hosted Zone provider."
           },
-          "name": "SSM_PARAMETER_PROVIDER"
+          "name": "HOSTED_ZONE_PROVIDER"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "VPC Provider."
+            "summary": "KMS Key Provider."
           },
-          "name": "VPC_PROVIDER"
+          "name": "KEY_PROVIDER"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "VPC Endpoint Service AZ Provider."
+            "summary": "Load balancer listener provider."
           },
-          "name": "ENDPOINT_SERVICE_AVAILABILITY_ZONE_PROVIDER"
+          "name": "LOAD_BALANCER_LISTENER_PROVIDER"
         },
         {
           "docs": {
@@ -1347,23 +1384,23 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Load balancer listener provider."
+            "summary": "Security group provider."
           },
-          "name": "LOAD_BALANCER_LISTENER_PROVIDER"
+          "name": "SECURITY_GROUP_PROVIDER"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "Security group provider."
+            "summary": "SSM Parameter Provider."
           },
-          "name": "SECURITY_GROUP_PROVIDER"
+          "name": "SSM_PARAMETER_PROVIDER"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "KMS Key Provider."
+            "summary": "VPC Provider."
           },
-          "name": "KEY_PROVIDER"
+          "name": "VPC_PROVIDER"
         }
       ],
       "name": "ContextProvider",
@@ -1374,7 +1411,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\nconst dockerImageAsset: cloud_assembly_schema.DockerImageAsset = {\n  destinations: {\n    destinationsKey: {\n      imageTag: 'imageTag',\n      repositoryName: 'repositoryName',\n\n      // the properties below are optional\n      assumeRoleArn: 'assumeRoleArn',\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      region: 'region',\n    },\n  },\n  source: {\n    directory: 'directory',\n    dockerBuildArgs: {\n      dockerBuildArgsKey: 'dockerBuildArgs',\n    },\n    dockerBuildTarget: 'dockerBuildTarget',\n    dockerFile: 'dockerFile',\n    executable: ['executable'],\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageAsset",
       "kind": "interface",
@@ -1429,7 +1470,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\nconst dockerImageDestination: cloud_assembly_schema.DockerImageDestination = {\n  imageTag: 'imageTag',\n  repositoryName: 'repositoryName',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageDestination",
       "interfaces": [
@@ -1482,7 +1527,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';\n\nconst dockerImageSource: cloud_assembly_schema.DockerImageSource = {\n  directory: 'directory',\n  dockerBuildArgs: {\n    dockerBuildArgsKey: 'dockerBuildArgs',\n  },\n  dockerBuildTarget: 'dockerBuildTarget',\n  dockerFile: 'dockerFile',\n  executable: ['executable'],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.DockerImageSource",
       "kind": "interface",
@@ -1604,7 +1653,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\nconst endpointServiceAvailabilityZonesContextQuery: cloud_assembly_schema.EndpointServiceAvailabilityZonesContextQuery = {\n  account: 'account',\n  region: 'region',\n  serviceName: 'serviceName',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.EndpointServiceAvailabilityZonesContextQuery",
       "kind": "interface",
@@ -1633,15 +1686,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 247
+            "line": 254
           },
-          "name": "region",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -1650,14 +1705,14 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Query service name."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 259
+            "line": 247
           },
-          "name": "serviceName",
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -1665,17 +1720,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query service name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 254
+            "line": 259
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "serviceName",
           "type": {
             "primitive": "string"
           }
@@ -1688,7 +1741,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\nconst fileAsset: cloud_assembly_schema.FileAsset = {\n  destinations: {\n    destinationsKey: {\n      bucketName: 'bucketName',\n      objectKey: 'objectKey',\n\n      // the properties below are optional\n      assumeRoleArn: 'assumeRoleArn',\n      assumeRoleExternalId: 'assumeRoleExternalId',\n      region: 'region',\n    },\n  },\n  source: {\n    executable: ['executable'],\n    packaging: cloud_assembly_schema.FileAssetPackaging.FILE,\n    path: 'path',\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileAsset",
       "kind": "interface",
@@ -1743,7 +1800,11 @@
       "datatype": true,
       "docs": {
         "stability": "stable",
-        "summary": "Metadata Entry spec for files."
+        "summary": "Metadata Entry spec for files.",
+        "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\nconst fileAssetMetadataEntry: cloud_assembly_schema.FileAssetMetadataEntry = {\n  artifactHashParameter: 'artifactHashParameter',\n  id: 'id',\n  packaging: 'packaging',\n  path: 'path',\n  s3BucketParameter: 's3BucketParameter',\n  s3KeyParameter: 's3KeyParameter',\n  sourceHash: 'sourceHash',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileAssetMetadataEntry",
       "kind": "interface",
@@ -1904,7 +1965,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\nconst fileDestination: cloud_assembly_schema.FileDestination = {\n  bucketName: 'bucketName',\n  objectKey: 'objectKey',\n\n  // the properties below are optional\n  assumeRoleArn: 'assumeRoleArn',\n  assumeRoleExternalId: 'assumeRoleExternalId',\n  region: 'region',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.FileDestination",
       "interfaces": [
@@ -1957,7 +2022,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';\n\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",
@@ -2036,7 +2105,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\nconst hostedZoneContextQuery: cloud_assembly_schema.HostedZoneContextQuery = {\n  account: 'account',\n  domainName: 'domainName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  privateZone: false,\n  vpcId: 'vpcId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.HostedZoneContextQuery",
       "kind": "interface",
@@ -2066,30 +2139,14 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "The domain name e.g. example.com to lookup."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 139
-          },
-          "name": "domainName",
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Query region."
+            "summary": "The domain name e.g. example.com to lookup."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 127
+            "line": 139
           },
-          "name": "region",
+          "name": "domainName",
           "type": {
             "primitive": "string"
           }
@@ -2130,6 +2187,22 @@
             "primitive": "boolean"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Query region."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 127
+          },
+          "name": "region",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -2157,13 +2230,17 @@
       "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\nconst keyContextQuery: cloud_assembly_schema.KeyContextQuery = {\n  account: 'account',\n  aliasName: 'aliasName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.KeyContextQuery",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/cloud-assembly/context-queries.ts",
-        "line": 426
+        "line": 442
       },
       "name": "KeyContextQuery",
       "properties": [
@@ -2176,7 +2253,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 430
+            "line": 446
           },
           "name": "account",
           "type": {
@@ -2192,7 +2269,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 447
+            "line": 463
           },
           "name": "aliasName",
           "type": {
@@ -2202,15 +2279,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 435
+            "line": 458
           },
-          "name": "region",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -2218,17 +2297,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 442
+            "line": 451
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -2241,7 +2318,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\nconst loadBalancerContextQuery: cloud_assembly_schema.LoadBalancerContextQuery = {\n  account: 'account',\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n  region: 'region',\n\n  // the properties below are optional\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerContextQuery",
       "interfaces": [
@@ -2273,15 +2354,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 311
+            "line": 318
           },
-          "name": "region",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -2289,17 +2372,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 318
+            "line": 311
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -2312,7 +2393,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\nconst loadBalancerFilter: cloud_assembly_schema.LoadBalancerFilter = {\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n\n  // the properties below are optional\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerFilter",
       "kind": "interface",
@@ -2322,22 +2407,6 @@
       },
       "name": "LoadBalancerFilter",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Filter load balancers by their type."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 284
-          },
-          "name": "loadBalancerType",
-          "type": {
-            "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerType"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -2378,6 +2447,22 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Filter load balancers by their type."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 284
+          },
+          "name": "loadBalancerType",
+          "type": {
+            "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerType"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/context-queries:LoadBalancerFilter"
@@ -2387,7 +2472,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\nconst loadBalancerListenerContextQuery: cloud_assembly_schema.LoadBalancerListenerContextQuery = {\n  account: 'account',\n  loadBalancerType: cloud_assembly_schema.LoadBalancerType.NETWORK,\n  region: 'region',\n\n  // the properties below are optional\n  listenerArn: 'listenerArn',\n  listenerPort: 123,\n  listenerProtocol: cloud_assembly_schema.LoadBalancerListenerProtocol.HTTP,\n  loadBalancerArn: 'loadBalancerArn',\n  loadBalancerTags: [{\n    key: 'key',\n    value: 'value',\n  }],\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.LoadBalancerListenerContextQuery",
       "interfaces": [
@@ -2416,22 +2505,6 @@
             "primitive": "string"
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "Query region."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 368
-          },
-          "name": "region",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -2503,6 +2576,22 @@
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Query region."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 368
+          },
+          "name": "region",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/context-queries:LoadBalancerListenerContextQuery"
@@ -2544,23 +2633,23 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "TLS protocol."
+            "summary": "TCP and UDP protocol."
           },
-          "name": "TLS"
+          "name": "TCP_UDP"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "UDP protocol."
+            "summary": "TLS protocol."
           },
-          "name": "UDP"
+          "name": "TLS"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "TCP and UDP protocol."
+            "summary": "UDP protocol."
           },
-          "name": "TCP_UDP"
+          "name": "UDP"
         }
       ],
       "name": "LoadBalancerListenerProtocol",
@@ -2582,16 +2671,16 @@
         {
           "docs": {
             "stability": "stable",
-            "summary": "Network load balancer."
+            "summary": "Application load balancer."
           },
-          "name": "NETWORK"
+          "name": "APPLICATION"
         },
         {
           "docs": {
             "stability": "stable",
-            "summary": "Application load balancer."
+            "summary": "Network load balancer."
           },
-          "name": "APPLICATION"
+          "name": "NETWORK"
         }
       ],
       "name": "LoadBalancerType",
@@ -2809,7 +2898,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';\n\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",
@@ -2819,22 +2912,6 @@
       },
       "name": "MetadataEntry",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The type of the metadata entry."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/cloud-assembly/metadata-schema.ts",
-            "line": 208
-          },
-          "name": "type",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -2895,6 +2972,22 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The type of the metadata entry."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/metadata-schema.ts",
+            "line": 208
+          },
+          "name": "type",
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/cloud-assembly/metadata-schema:MetadataEntry"
@@ -2904,7 +2997,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\nconst missingContext: cloud_assembly_schema.MissingContext = {\n  key: 'key',\n  props: {\n    account: 'account',\n    filters: {\n      filtersKey: ['filters'],\n    },\n    region: 'region',\n\n    // the properties below are optional\n    lookupRoleArn: 'lookupRoleArn',\n    owners: ['owners'],\n  },\n  provider: cloud_assembly_schema.ContextProvider.AMI_PROVIDER,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.MissingContext",
       "kind": "interface",
@@ -3003,7 +3100,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';\n\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",
@@ -3055,7 +3156,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';\n\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",
@@ -3094,7 +3199,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\nconst sSMParameterContextQuery: cloud_assembly_schema.SSMParameterContextQuery = {\n  account: 'account',\n  parameterName: 'parameterName',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SSMParameterContextQuery",
       "kind": "interface",
@@ -3123,15 +3232,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Parameter name to query."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 183
+            "line": 178
           },
-          "name": "parameterName",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -3140,14 +3251,14 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "Parameter name to query."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 171
+            "line": 183
           },
-          "name": "region",
+          "name": "parameterName",
           "type": {
             "primitive": "string"
           }
@@ -3155,17 +3266,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 178
+            "line": 171
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -3178,7 +3287,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\nconst securityGroupContextQuery: cloud_assembly_schema.SecurityGroupContextQuery = {\n  account: 'account',\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  securityGroupId: 'securityGroupId',\n  securityGroupName: 'securityGroupName',\n  vpcId: 'vpcId',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.SecurityGroupContextQuery",
       "kind": "interface",
@@ -3204,6 +3317,24 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- None",
+            "stability": "stable",
+            "summary": "The ARN of the role that should be used to look up the missing values."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 415
+          },
+          "name": "lookupRoleArn",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -3223,15 +3354,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
             "summary": "Security group id."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 420
+            "line": 422
           },
           "name": "securityGroupId",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -3241,14 +3374,32 @@
           "docs": {
             "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Security group name."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 415
+            "line": 429
           },
-          "name": "lookupRoleArn",
+          "name": "securityGroupName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- None",
+            "stability": "stable",
+            "summary": "VPC ID."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/cloud-assembly/context-queries.ts",
+            "line": 436
+          },
+          "name": "vpcId",
           "optional": true,
           "type": {
             "primitive": "string"
@@ -3262,7 +3413,11 @@
       "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';\n\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",
@@ -3314,7 +3469,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';\n\nconst treeArtifactProperties: cloud_assembly_schema.TreeArtifactProperties = {\n  file: 'file',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.TreeArtifactProperties",
       "kind": "interface",
@@ -3348,7 +3507,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\nconst vpcContextQuery: cloud_assembly_schema.VpcContextQuery = {\n  account: 'account',\n  filter: {\n    filterKey: 'filter',\n  },\n  region: 'region',\n\n  // the properties below are optional\n  lookupRoleArn: 'lookupRoleArn',\n  returnAsymmetricSubnets: false,\n  subnetGroupNameTag: 'subnetGroupNameTag',\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
       },
       "fqn": "@aws-cdk/cloud-assembly-schema.VpcContextQuery",
       "kind": "interface",
@@ -3400,15 +3563,17 @@
         {
           "abstract": true,
           "docs": {
+            "default": "- None",
             "stability": "stable",
-            "summary": "Query region."
+            "summary": "The ARN of the role that should be used to look up the missing values."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 198
+            "line": 205
           },
-          "name": "region",
+          "name": "lookupRoleArn",
+          "optional": true,
           "type": {
             "primitive": "string"
           }
@@ -3416,17 +3581,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- None",
             "stability": "stable",
-            "summary": "The ARN of the role that should be used to look up the missing values."
+            "summary": "Query region."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/cloud-assembly/context-queries.ts",
-            "line": 205
+            "line": 198
           },
-          "name": "lookupRoleArn",
-          "optional": true,
+          "name": "region",
           "type": {
             "primitive": "string"
           }
@@ -3472,6 +3635,6 @@
       "symbolId": "lib/cloud-assembly/context-queries:VpcContextQuery"
     }
   },
-  "version": "1.131.0",
-  "fingerprint": "AKO0CcwwHsOMhjVRpBqQ++Jz5NTEcfGwrz3Jtkcllyo="
+  "version": "1.135.0",
+  "fingerprint": "**********"
 }