chore: Corrected typos (#24794)

Spelling updates, no logic changes.

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: Naumel

packages/@aws-cdk/core/lib/app.ts

@@ -181,7 +181,7 @@ export class App extends Stage {
 
     const autoSynth = props.autoSynth ?? cxapi.OUTDIR_ENV in process.env;
     if (autoSynth) {
-      // synth() guarantuees it will only execute once, so a default of 'true'
+      // synth() guarantees it will only execute once, so a default of 'true'
       // doesn't bite manual calling of the function.
       process.once('beforeExit', () => this.synth());
     }

packages/@aws-cdk/core/lib/assets.ts

@@ -330,7 +330,7 @@ export interface FileAssetLocation {
   /**
    * Like `s3ObjectUrl`, but not suitable for CloudFormation consumption
    *
-   * If there are placeholders in the S3 URL, they will be returned unreplaced
+   * If there are placeholders in the S3 URL, they will be returned un-replaced
    * and un-evaluated.
    *
    * @default - This feature cannot be used

packages/@aws-cdk/core/lib/bundling.ts

@@ -155,7 +155,7 @@ export enum BundlingOutput {
 
   /**
    * If the bundling output directory contains a single archive file (zip or jar)
-   * it will be used as the bundle output as-is. Otherwise all the files in the bundling output directory will be zipped.
+   * it will be used as the bundle output as-is. Otherwise, all the files in the bundling output directory will be zipped.
    */
   AUTO_DISCOVER = 'auto-discover',
 }
@@ -362,7 +362,7 @@ export class DockerImage extends BundlingDockerImage {
   public readonly image: string;
 
   constructor(image: string, _imageHash?: string) {
-    // It is preferrable for the deprecated class to inherit a non-deprecated class.
+    // It is preferable for the deprecated class to inherit a non-deprecated class.
     // However, in this case, the opposite has occurred which is incompatible with
     // a deprecation feature. See https://github.com/aws/jsii/issues/3102.
     const deprecated = quiet();
@@ -379,7 +379,7 @@ export class DockerImage extends BundlingDockerImage {
    * @return The overridden image name if set or image hash name in that order
    */
   public toJSON() {
-    // It is preferrable for the deprecated class to inherit a non-deprecated class.
+    // It is preferable for the deprecated class to inherit a non-deprecated class.
     // However, in this case, the opposite has occurred which is incompatible with
     // a deprecation feature. See https://github.com/aws/jsii/issues/3102.
     const deprecated = quiet();
@@ -394,7 +394,7 @@ export class DockerImage extends BundlingDockerImage {
    * Runs a Docker image
    */
   public run(options: DockerRunOptions = {}) {
-    // It is preferrable for the deprecated class to inherit a non-deprecated class.
+    // It is preferable for the deprecated class to inherit a non-deprecated class.
     // However, in this case, the opposite has occurred which is incompatible with
     // a deprecation feature. See https://github.com/aws/jsii/issues/3102.
     const deprecated = quiet();
@@ -415,7 +415,7 @@ export class DockerImage extends BundlingDockerImage {
    * @returns the destination path
    */
   public cp(imagePath: string, outputPath?: string): string {
-    // It is preferrable for the deprecated class to inherit a non-deprecated class.
+    // It is preferable for the deprecated class to inherit a non-deprecated class.
     // However, in this case, the opposite has occurred which is incompatible with
     // a deprecation feature. See https://github.com/aws/jsii/issues/3102.
     const deprecated = quiet();

packages/@aws-cdk/core/lib/cfn-condition.ts

@@ -89,7 +89,7 @@ export class CfnCondition extends CfnElement implements ICfnConditionExpression,
 export interface ICfnConditionExpression extends IResolvable {}
 
 /**
- * Interface to specify certain functions as Service Catalog rule-specifc.
+ * Interface to specify certain functions as Service Catalog rule-specific.
  * These functions can only be used in ``Rules`` section of template.
  */
 export interface ICfnRuleConditionExpression extends ICfnConditionExpression {

packages/@aws-cdk/core/lib/cfn-element.ts

@@ -177,14 +177,14 @@ export abstract class CfnElement extends Construct {
 }
 
 /**
- * Base class for referenceable CloudFormation constructs which are not Resources
+ * Base class for referencable CloudFormation constructs which are not Resources
  *
  * These constructs are things like Conditions and Parameters, can be
  * referenced by taking the `.ref` attribute.
  *
  * Resource constructs do not inherit from CfnRefElement because they have their
  * own, more specific types returned from the .ref attribute. Also, some
- * resources aren't referenceable at all (such as BucketPolicies or GatewayAttachments).
+ * resources aren't referencable at all (such as BucketPolicies or GatewayAttachments).
  */
 export abstract class CfnRefElement extends CfnElement {
   /**

packages/@aws-cdk/core/lib/cfn-fn.ts

@@ -16,7 +16,7 @@ import { Token } from './token';
 export class Fn {
   /**
    * The ``Ref`` intrinsic function returns the value of the specified parameter or resource.
-   * Note that it doesn't validate the logicalName, it mainly serves paremeter/resource reference defined in a ``CfnInclude`` template.
+   * Note that it doesn't validate the logicalName, it mainly serves parameter/resource reference defined in a ``CfnInclude`` template.
    * @param logicalName The logical name of a parameter/resource for which you want to retrieve its value.
    */
   public static ref(logicalName: string): string {
@@ -99,7 +99,7 @@ export class Fn {
    * @returns a token represented as a string array
    */
   public static split(delimiter: string, source: string, assumedLength?: number): string[] {
-    // short-circut if source is not a token
+    // short-circuit if source is not a token
     if (!Token.isUnresolved(source)) {
       return source.split(delimiter);
     }
@@ -420,7 +420,7 @@ export class Fn {
    * @param object The object or array to stringify
    */
   public static toJsonString(object: any): string {
-    // short-circut if object is not a token
+    // short-circuit if object is not a token
     if (!Token.isUnresolved(object)) {
       return JSON.stringify(object);
     }
@@ -434,7 +434,7 @@ export class Fn {
    * @param array The array you want to return the number of elements from
    */
   public static len(array: any): number {
-    // short-circut if array is not a token
+    // short-circuit if array is not a token
     if (!Token.isUnresolved(array)) {
       if (!Array.isArray(array)) {
         throw new Error('Fn.length() needs an array');
@@ -630,7 +630,7 @@ class FnCidr extends FnBase {
    */
   constructor(ipBlock: any, count: any, sizeMask?: any) {
     if (count < 1 || count > 256) {
-      throw new Error(`Fn::Cidr's count attribute must be betwen 1 and 256, ${count} was provided.`);
+      throw new Error(`Fn::Cidr's count attribute must be between 1 and 256, ${count} was provided.`);
     }
     super('Fn::Cidr', [ipBlock, count, sizeMask]);
   }
@@ -851,7 +851,7 @@ class FnJoin implements IResolvable {
   }
 
   /**
-   * Optimization: if an Fn::Join is nested in another one and they share the same delimiter, then flatten it up. Also,
+   * Optimization: if a Fn::Join is nested in another one and they share the same delimiter, then flatten it up. Also,
    * if two concatenated elements are literal strings (not tokens), then pre-concatenate them with the delimiter, to
    * generate shorter output.
    */

packages/@aws-cdk/core/lib/cfn-json.ts

@@ -63,7 +63,7 @@ export class CfnJson extends Construct implements IResolvable {
   }
 
   /**
-   * This is required in case someone JSON.stringifys an object which refrences
+   * This is required in case someone JSON.stringifys an object which references
    * this object. Otherwise, we'll get a cyclic JSON reference.
    */
   public toJSON() {

packages/@aws-cdk/core/lib/cfn-resource.ts

@@ -221,7 +221,7 @@ export class CfnResource extends CfnRefElement {
    * template.
    *
    * @param path - The path of the property, you can use dot notation to
-   *        override values in complex types. Any intermdediate keys
+   *        override values in complex types. Any intermediate keys
    *        will be created as needed.
    * @param value - The value. Could be primitive or complex.
    */

packages/@aws-cdk/core/lib/duration.ts

@@ -63,7 +63,7 @@ export class Duration {
    * Parse a period formatted according to the ISO 8601 standard
    *
    * @see https://www.iso.org/standard/70907.html
-   * @param duration an ISO-formtted duration to be parsed.
+   * @param duration an ISO-formatted duration to be parsed.
    * @returns the parsed `Duration`.
    */
   public static parse(duration: string): Duration {

packages/@aws-cdk/core/lib/expiration.ts

@@ -40,21 +40,21 @@ export class Expiration {
   }
 
   /**
-   * Exipration Value in a formatted Unix Epoch Time in seconds
+   * Expiration Value in a formatted Unix Epoch Time in seconds
    */
   public toEpoch(): number {
     return Math.round(this.date.getTime() / 1000);
   }
   /**
-   * Check if Exipiration expires before input
+   * Check if Expiration expires before input
    * @param t the duration to check against
    */
   public isBefore(t: Duration): boolean {
     return this.date < new Date(Date.now() + t.toMilliseconds());
   }
 
   /**
-   * Check if Exipiration expires after input
+   * Check if Expiration expires after input
    * @param t the duration to check against
    */
   public isAfter( t: Duration ): boolean {

packages/@aws-cdk/core/lib/lazy.ts

@@ -336,7 +336,7 @@ abstract class LazyBase<A> implements IResolvable {
   private _cached?: A;
 
   constructor(private readonly producer: ILazyProducer<A>, private readonly cache: boolean) {
-    // Stack trace capture is conditionned to `debugModeEnabled()`, because
+    // Stack trace capture is conditioned to `debugModeEnabled()`, because
     // lazies can be created in a fairly thrashy way, and the stack traces are
     // large and slow to obtain; but are mostly useful only when debugging a
     // resolution issue.

packages/@aws-cdk/core/lib/nested-stack.ts

@@ -211,9 +211,9 @@ export class NestedStack extends Stack {
     }
 
     // When adding tags to nested stack, the tags need to be added to all the resources in
-    // in nested stack, which is handled by the `tags` property, But to tag the
+    // nested stack, which is handled by the `tags` property, But to tag the
     //  tags have to be added in the parent stack CfnStack resource. The CfnStack resource created
-    // by this class dont share the same TagManager as that of the one exposed by the `tag` property of the
+    // by this class don't share the same TagManager as that of the one exposed by the `tag` property of the
     //  class, all the tags need to be copied to the CfnStack resource before synthesizing the resource.
     // See https://github.com/aws/aws-cdk/pull/19128
     Object.entries(this.tags.tagValues()).forEach(([key, value]) => {

packages/@aws-cdk/core/lib/physical-name.ts

@@ -13,7 +13,7 @@ export class PhysicalName {
    * If you are certain that a resource will be referenced across environments,
    * you may also specify an explicit physical name for it. This option is
    * mostly designed for reusable constructs which may or may not be referenced
-   * acrossed environments.
+   * across environments.
    */
   public static readonly GENERATE_IF_NEEDED = Token.asString(new GeneratedWhenNeededMarker());
 

packages/@aws-cdk/core/lib/private/cfn-reference.ts

@@ -71,7 +71,7 @@ export class CfnReference extends Reference {
   }
 
   /**
-   * Return a CfnReference that references a pseudo referencd
+   * Return a CfnReference that references a pseudo referenced
    */
   public static forPseudo(pseudoName: string, scope: Construct) {
     return CfnReference.singletonReference(scope, `Pseudo:${pseudoName}`, undefined, () => {

packages/@aws-cdk/core/lib/private/cfn-utils-provider.ts

@@ -22,7 +22,7 @@ export abstract class CfnUtils {
   /**
    * Encode a structure to JSON at CloudFormation deployment time
    *
-   * This would have been suitable for the JSON-encoding of abitrary structures, however:
+   * This would have been suitable for the JSON-encoding of arbitrary structures, however:
    *
    * - It uses a custom resource to do the encoding, and we'd rather not use a custom
    *   resource if we can avoid it.

packages/@aws-cdk/core/lib/private/cloudformation-lang.ts

@@ -55,7 +55,7 @@ export class CloudFormationLang {
 }
 
 /**
- * Return a CFN intrinsic mass concatting any number of CloudFormation expressions
+ * Return a CFN intrinsic mass concatenating any number of CloudFormation expressions
  */
 function fnJoinConcat(parts: any[]) {
   return { 'Fn::Join': ['', minimalCloudFormationJoin('', parts)] };
@@ -110,7 +110,7 @@ function fnJoinConcat(parts: any[]) {
  *   values is lost).
  *
  *   To fix this, "type hints" have been added to the `resolve()` function,
- *   giving an idea of the type of the source value for compplex result values.
+ *   giving an idea of the type of the source value for complex result values.
  *   This only works for objects (not strings and numbers) but fortunately
  *   we only care about the types of intrinsics, which are always complex values.
  *
@@ -163,7 +163,7 @@ function tokenAwareStringify(root: any, space: number, ctx: IResolveContext) {
     if (obj === undefined) { return; }
 
     if (Token.isUnresolved(obj)) {
-      throw new Error('This shouldnt happen anymore');
+      throw new Error("This shouldn't happen anymore");
     }
     if (Array.isArray(obj)) {
       return renderCollection('[', ']', obj, recurse);

packages/@aws-cdk/core/lib/private/logical-id.ts

@@ -52,7 +52,7 @@ export class LogicalIDs {
   /**
    * Throw an error if not all renames have been used
    *
-   * This is to assure that users didn't make typoes when registering renames.
+   * This is to assure that users didn't make typos when registering renames.
    */
   public assertAllRenamesApplied() {
     const keys = new Set<string>();

packages/@aws-cdk/core/lib/private/prepare-app.ts

@@ -44,7 +44,7 @@ export function prepareApp(root: IConstruct) {
 
     // ▷[ Given the legacy synthesizer and a 3-or-deeper nesting of nested stacks ]
     //
-    // Adding nested stack assets may haved added CfnParameters to the top-level
+    // Adding nested stack assets may have added CfnParameters to the top-level
     // stack which are referenced in a deeper-level stack. The values of these
     // parameters need to be carried through to the right location via Nested
     // Stack parameters, which `resolveReferences()` will do.

packages/@aws-cdk/core/lib/removal-policy.ts

@@ -54,7 +54,7 @@ export interface RemovalPolicyOptions {
   /**
    * The default policy to apply in case the removal policy is not defined.
    *
-   * @default - Default value is resource specific. To determine the default value for a resoure,
+   * @default - Default value is resource specific. To determine the default value for a resource,
    * please consult that specific resource's documentation.
    */
   readonly default?: RemovalPolicy;

packages/@aws-cdk/core/lib/resource.ts

@@ -165,7 +165,7 @@ export abstract class Resource extends Construct implements IResource {
     this.stack = Stack.of(this);
 
     const parsedArn = props.environmentFromArn ?
-      // Since we only want the region and account, NO_RESOURE_NAME is good enough
+      // Since we only want the region and account, NO_RESOURCE_NAME is good enough
       this.stack.splitArn(props.environmentFromArn, ArnFormat.NO_RESOURCE_NAME)
       : undefined;
     this.env = {
@@ -201,7 +201,7 @@ export abstract class Resource extends Construct implements IResource {
    * Called when this resource is referenced across environments
    * (account/region) to order to request that a physical name will be generated
    * for this resource during synthesis, so the resource can be referenced
-   * through it's absolute name/arn.
+   * through its absolute name/arn.
    *
    * @internal
    */

packages/@aws-cdk/core/lib/runtime.ts

@@ -344,7 +344,7 @@ export function requireProperty(props: { [name: string]: any }, name: string, co
 /**
  * Validates if any of the given validators matches
  *
- * We add either/or words to the front of the error mesages so that they read
+ * We add either/or words to the front of the error messages so that they read
  * more nicely. Example:
  *
  *   Properties not correct for 'FunctionProps'

packages/@aws-cdk/core/lib/secret-value.ts

@@ -104,7 +104,7 @@ export class SecretValue extends Intrinsic {
     }
 
     if (options.versionStage && options.versionId) {
-      throw new Error(`verionStage: '${options.versionStage}' and versionId: '${options.versionId}' were both provided but only one is allowed`);
+      throw new Error(`versionStage: '${options.versionStage}' and versionId: '${options.versionId}' were both provided but only one is allowed`);
     }
 
     const parts = [

packages/@aws-cdk/core/lib/stack-synthesizers/asset-manifest-builder.ts

@@ -9,7 +9,7 @@ import { Stack } from '../stack';
 /**
  * Build an asset manifest from assets added to a stack
  *
- * This class does not need to be used by app builders; it is only nessary for building Stack Synthesizers.
+ * This class does not need to be used by app builders; it is only necessary for building Stack Synthesizers.
  */
 export class AssetManifestBuilder {
   private readonly files: NonNullable<cxschema.AssetManifest['files']> = {};

packages/@aws-cdk/core/lib/stack-synthesizers/cli-credentials-synthesizer.ts

@@ -42,7 +42,7 @@ export interface CliCredentialsStackSynthesizerProps {
    * Qualifier to disambiguate multiple environments in the same account
    *
    * You can use this and leave the other naming properties empty if you have deployed
-   * the bootstrap environment with standard names but only differnet qualifiers.
+   * the bootstrap environment with standard names but only different qualifiers.
    *
    * @default - Value of context key '@aws-cdk/core:bootstrapQualifier' if set, otherwise `DefaultStackSynthesizer.DEFAULT_QUALIFIER`
    */

packages/@aws-cdk/core/lib/stack-synthesizers/default-synthesizer.ts

@@ -169,7 +169,7 @@ export interface DefaultStackSynthesizerProps {
    * Qualifier to disambiguate multiple environments in the same account
    *
    * You can use this and leave the other naming properties empty if you have deployed
-   * the bootstrap environment with standard names but only differnet qualifiers.
+   * the bootstrap environment with standard names but only different qualifiers.
    *
    * @default - Value of context key '@aws-cdk/core:bootstrapQualifier' if set, otherwise `DefaultStackSynthesizer.DEFAULT_QUALIFIER`
    */

packages/@aws-cdk/core/lib/stack-synthesizers/legacy.ts

@@ -36,7 +36,7 @@ const ASSETS_ECR_REPOSITORY_NAME_OVERRIDE_CONTEXT_KEY = 'assets-ecr-repository-n
  *   you must use the `DefaultStackSynthesizer`.
  * - Each asset will take up a CloudFormation Parameter in your template. Keep in
  *   mind that there is a maximum of 200 parameters in a CloudFormation template.
- *   To use determinstic asset locations instead, use `CliCredentialsStackSynthesizer`.
+ *   To use deterministic asset locations instead, use `CliCredentialsStackSynthesizer`.
  *
  * Be aware that your CLI credentials must be valid for the duration of the
  * entire deployment. If you are using session credentials, make sure the

packages/@aws-cdk/core/lib/stack-synthesizers/stack-synthesizer.ts

@@ -49,7 +49,7 @@ export abstract class StackSynthesizer implements IStackSynthesizer {
    *
    * The synthesizer must rely on some out-of-band mechanism to make sure the given files
    * are actually placed in the returned location before the deployment happens. This can
-   * be by writing the intructions to the asset manifest (for use by the `cdk-assets` tool),
+   * be by writing the instructions to the asset manifest (for use by the `cdk-assets` tool),
    * by relying on the CLI to upload files (legacy behavior), or some other operator controlled
    * mechanism.
    */
@@ -62,7 +62,7 @@ export abstract class StackSynthesizer implements IStackSynthesizer {
    *
    * The synthesizer must rely on some out-of-band mechanism to make sure the given files
    * are actually placed in the returned location before the deployment happens. This can
-   * be by writing the intructions to the asset manifest (for use by the `cdk-assets` tool),
+   * be by writing the instructions to the asset manifest (for use by the `cdk-assets` tool),
    * by relying on the CLI to upload files (legacy behavior), or some other operator controlled
    * mechanism.
    */

packages/@aws-cdk/core/lib/stack-trace.ts

@@ -5,7 +5,7 @@ import { debugModeEnabled } from './debug';
  *
  * Stack traces are often invaluable tools to help diagnose problems, however
  * their capture is a rather expensive operation, and the stack traces can be
- * large. Consequently, users are stronly advised to condition capturing stack
+ * large. Consequently, users are strongly advised to condition capturing stack
  * traces to specific user opt-in.
  *
  * Stack traces will only be captured if the `CDK_DEBUG` environment variable